From 867fe6ded1283f30b093b59e0c7bc96408788c8e Mon Sep 17 00:00:00 2001 From: naghim Date: Fri, 8 Mar 2024 11:40:58 +0200 Subject: [PATCH] Add README --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++ subassistant/gui/tab.py | 2 +- 2 files changed, 60 insertions(+), 1 deletion(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..5c4f2b1 --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +#

{ SubAssistant }

+ +

SubAssistant is a specialized desktop application designed to simplify the translation process for subtitle files, specifically .ass (Advanced SubStation Alpha) format. Tailored for translators, SubAssisntant facilitates seamless collaboration by allowing users to comment out the original English dialogue text, write their translations alongside it, and enable proofreaders or quality checkers to review both versions within the same file. By providing a unified platform for bilingual text management, this application enhances the efficiency and accuracy of subtitle translation workflows.

+ +

+ SubAssistant screenshot +

+ +## Installation + +### Windows + +1. Download the latest release from the [Releases](https://github.com/naghim/SubAssistant/releases) page. +2. Double-click the downloaded `.exe` file to launch the application. + +### Linux and macOS + +Currently, there is no standalone executable for Linux and macOS. You can still run SubAssistant using Python as described below. + +### Using Python + +#### Pre-requisites + +- Ensure you have Python 3.12 installed on your system. +- Make sure `pip` is installed. You can check by running `pip --version` in your terminal. + +#### Installation Steps + +1. Clone this repository to your local machine: + +```bash +git clone https://github.com/naghim/SubAssistant.git +``` + +2. Navigate to the project directory: + +```bash +cd SubAssistant +``` + +3. Install the required dependencies: + +```bash +pip install -r requirements.txt +``` + +4. Run the application: + +```bash +python -m subassistant +``` + +## FAQ + +

👀 How to use SubAssistant?
Using SubAssistant is a piece of cake! Choose the action you wish to take from the side menu—whether to comment out text or delete comments. Use the "Select File" button to open the .ass file. The program will automatically propose an output filename within the same folder. If you prefer a different folder or wish to rename the output, utilize the "Browse" button or directly edit the output path. Upon clicking the button, the selected operation will be executed.

+ +

👀 Can SubAssistant mess up my subtitles?
No, SubAssistant will always generate a new file with the modifications, does not do any editing in the input file, so your subtitles are safe!

+ +

👀 Can SubAssistant handle .srt files?
No, currently SubAssistant does not support .srt files. /p> diff --git a/subassistant/gui/tab.py b/subassistant/gui/tab.py index 0221aee..8d8578d 100644 --- a/subassistant/gui/tab.py +++ b/subassistant/gui/tab.py @@ -132,7 +132,7 @@ def initUI(self): self.text_logo = QLabel("

SubAssistant

" ) - self.text = QLabel("

👀 What is this? This is a specialized desktop application designed to simplify the translation process for subtitle files, specifically .ass (Advanced SubStation Alpha) format. Tailored for translators, CommentOut facilitates seamless collaboration by allowing users to comment out the original English dialogue text, write their translations alongside it, and enable proofreaders or quality checkers to review both versions within the same file. By providing a unified platform for bilingual text management, this application enhances the efficiency and accuracy of subtitle translation workflows.

" + self.text = QLabel("

👀 What is this? This is a specialized desktop application designed to simplify the translation process for subtitle files, specifically .ass (Advanced SubStation Alpha) format. Tailored for translators, SubAssistant facilitates seamless collaboration by allowing users to comment out the original English dialogue text, write their translations alongside it, and enable proofreaders or quality checkers to review both versions within the same file. By providing a unified platform for bilingual text management, this application enhances the efficiency and accuracy of subtitle translation workflows.

" ) self.text_how_to = QLabel("

👀 How to use? Choose the action you wish to take from the side menu—whether to comment out text or delete comments. Use the \"Select File\" button to open the .ass file. The program will automatically propose an output filename within the same folder. If you prefer a different folder or wish to rename the output, utilize the \"Browse\" button or directly edit the output path. Upon clicking the button, the selected operation will be executed.

"