Add README

naghim · Mar 8, 2024 · 867fe6d · 867fe6d
1 parent 0bcb984
commit 867fe6d
Show file tree

Hide file tree

Showing 2 changed files with 60 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -0,0 +1,59 @@
+# <p align='center'>{ Sub<span style="color: #d9073f">Assistant }</span></p>
+
+<p align='justify'>SubAssistant is a specialized desktop application designed to simplify the translation process for subtitle files, specifically <code>.ass</code> (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.</p>
+
+<p align="center">
+  <img width="400" src="https://i.imgur.com/vvzOFnF.png"" alt="SubAssistant screenshot"/>
+</p>
+
+## 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
+
+<p align='justify'><b> 👀 How to use SubAssistant?</b> </br>  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.</p>
+
+<p align='justify'><b> 👀 Can SubAssistant mess up my subtitles?</b> </br> 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!</p>
+
+<p align='justify'><b> 👀 Can SubAssistant handle <code>.srt</code> files?</b></br> No, currently SubAssistant does not support <code>.srt</code> files. /p>
diff --git a/subassistant/gui/tab.py b/subassistant/gui/tab.py
@@ -132,7 +132,7 @@ def initUI(self):
         self.text_logo = QLabel("<html><head/><body><p align='center'>Sub<span style=\"color: #d9073f\">Assistant</span></p></body></html>"
         )
 
-        self.text = QLabel("<html><head/><body><p align='justify'><b> 👀 What is this?</b> 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.</p></body></html>"
+        self.text = QLabel("<html><head/><body><p align='justify'><b> 👀 What is this?</b> 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.</p></body></html>"
         )
 
         self.text_how_to = QLabel("<html><head/><body><p align='justify'><b> 👀 How to use?</b> 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.</p></body></html>"