assy 6.2__tar.gz → 6.4__tar.gz

{assy-6.2 → assy-6.4}/.gitignore

@@ -35,3 +35,8 @@ main/resources/versions.json
 test_subtitles/
 PROMPTS.md
 build_tools/
+
+# Input/output directories
+input/
+output/
+desktop/

assy-6.4/CHANGELOG

@@ -0,0 +1,8 @@
+- **Headless CLI:** Added headless CLI for autonomous subtitle sync pipelines. Contributed by @Aidenir in PR [#86](https://github.com/denizsafak/AutoSubSync/pull/86):
+  >Introduces assy-cli with five subcommands (sync, shift, batch, config, version), JSON output mode, structured exit codes, and a slim Docker image - so AutoSubSync can run in CI/CD, scheduled jobs, and containers without a display or Qt event loop. The sync engine logic was extracted from SyncProcess into a new sync_core module that knows nothing about Qt; SyncProcess is now a thin adapter that wires Qt signals to sync_core callbacks. The pairing logic moved to a new pairing module the GUI re-imports. utils.py drops its top-level QtWidgets/QtGui imports so the CLI never loads Qt display libraries at runtime.
+  
+  See [Command-line interface (assy-cli)](https://github.com/denizsafak/AutoSubSync#command-line-interface-assy-cli) for detailed instructions.
+- **Python 3.14+ Compatibility:** Added a shim for `pkg_resources` to ensure compatibility with legacy dependencies (like `autosubsync`) that fail in recent Python versions where `setuptools` is not installed by default, Updated `pyproject.toml` to allow installation on Python 3.14. Contributed by @MateusSantos14 in PR [#85](https://github.com/denizsafak/AutoSubSync/pull/85)
+- **Custom Subtitle Suffix:** Added a new option called `Add custom suffix for subtitles` in settings to define a default custom suffix for processed subtitles. All save locations (except "Overwrite input subtitle") will append this suffix to the output file name, added `--suffix` parameter in both CLI subcommands (`sync` and `batch`).
+- Fixed `No executable found for alass` error in Windows with PyPI build, mentioned by @Milor123 in issue [#84](https://github.com/denizsafak/AutoSubSync/issues/79)
+- `Auto-Pairing with Season/Episode` now sorts paired items correctly before adding to batch view, mentioned by @enchained in issue [#71](https://github.com/denizsafak/AutoSubSync/issues/71)

assy-6.4/Dockerfile.cli

@@ -0,0 +1,39 @@
+# Slim, headless image for autonomous pipeline use of AutoSubSync.
+# Contains only what the CLI needs - no X11, VNC, or Qt display deps.
+# main/cli.py is engineered to not load PyQt6 QtWidgets/QtGui at runtime,
+# so the slim image works even though PyQt6 is still a transitive install dep.
+
+# --- Builder stage: compile native deps (webrtcvad etc.) ---
+FROM python:3.11-slim-bookworm AS builder
+
+ENV PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY pyproject.toml README.md ./
+COPY main ./main
+RUN python -m pip install --prefix=/install .
+
+# --- Runtime stage: just glibc + libstdc++ + the installed wheels ---
+FROM python:3.11-slim-bookworm
+
+ENV PYTHONUNBUFFERED=1
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        libstdc++6 \
+        libglib2.0-0 \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /install /usr/local
+
+WORKDIR /data
+VOLUME ["/data"]
+
+ENTRYPOINT ["assy-cli"]
+CMD ["--help"]

{assy-6.2 → assy-6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: assy
-Version: 6.2
+Version: 6.4
 Summary: Automatic subtitle synchronization tool.
 Project-URL: Homepage, https://github.com/denizsafak/AutoSubSync
 Project-URL: Documentation, https://github.com/denizsafak/AutoSubSync
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Video
 Classifier: Topic :: Text Processing
-Requires-Python: <3.14,>=3.10
+Requires-Python: >=3.10
 Requires-Dist: autosubsync
 Requires-Dist: chardet
 Requires-Dist: charset-normalizer
@@ -45,10 +45,12 @@ Description-Content-Type: text/markdown
 
 [![Build Status](https://github.com/denizsafak/AutoSubSync/actions/workflows/app.yml/badge.svg)](https://github.com/denizsafak/AutoSubSync/actions)
 <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
-[![GitHub Release](https://img.shields.io/github/v/release/denizsafak/AutoSubSync)](https://github.com/denizsafak/AutoSubSync/releases/latest)
 [![PyPI version](https://img.shields.io/pypi/v/assy)](https://pypi.org/project/assy/)
+[![GitHub Release](https://img.shields.io/github/v/release/denizsafak/AutoSubSync)](https://github.com/denizsafak/AutoSubSync/releases/latest)
 [![Operating Systems](https://img.shields.io/badge/os-windows%20%7C%20linux%20%7C%20macos%20-blue)](https://github.com/denizsafak/AutoSubSync/releases/latest)
-[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/denizsafak/AutoSubSync/total?color=blue)](https://github.com/denizsafak/AutoSubSync/releases/latest)
+![Pepy Total Downloads](https://img.shields.io/pepy/dt/assy?label=downloads%20(pypi)&color=blue)
+[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/denizsafak/AutoSubSync/total?color=blue&label=downloads%20(github))](https://github.com/denizsafak/AutoSubSync/releases/latest)
+
 
 AutoSubSync is a user-friendly tool that automatically synchronizes your subtitles with your videos using powerful tools such as [ffsubsync](https://github.com/smacke/ffsubsync), [autosubsync](https://github.com/oseiskar/autosubsync) and [alass](https://github.com/kaegi/alass). It also lets you manually adjust the subtitle timings. Just drag and drop your files, and let AutoSubSync do the rest, making subtitle alignment both simple and efficient.
 
@@ -98,7 +100,9 @@ yay -S autosubsync-bin
 > ```
 
 ### PyPI (All Platforms)
-You can install AutoSubSync using either pip or uv (a fast Python package manager) on any platform with Python 3.10+:
+[![PyPi Python Versions](https://img.shields.io/pypi/pyversions/assy)](https://pypi.org/project/assy/)
+
+You can install AutoSubSync using either pip or uv (a fast Python package manager) on any platform with Python 3.10 - 3.13:
 
 
 ```bash
@@ -109,7 +113,7 @@ pip install assy
 <summary><strong>With uv (click to expand)</strong></summary>
 
 ```bash
-uv pip install --system assy
+uv tool install assy
 ```
 
 </details>
@@ -123,7 +127,7 @@ pip install assy[torch]
 <summary><strong>With uv (click to expand)</strong></summary>
 
 ```bash
-uv pip install --system assy[torch]
+uv tool install assy[torch]
 ```
 
 </details>
@@ -133,23 +137,44 @@ uv pip install --system assy[torch]
 assy
 ```
 
+
 #### If your system Python is not compatible (e.g., macOS with older Python):
 
-If your system Python version is below 3.10 or above 3.13, you can use `uv` to automatically download a compatible Python version and run AutoSubSync:
+If your system Python version is below 3.10 or above 3.13, the recommended solution is to use [`uv`](https://docs.astral.sh/uv/getting-started/installation/) to install and run AutoSubSync with a compatible Python version automatically.
 
-```bash
-# One-liner to run AutoSubSync with a compatible Python (downloads Python 3.12 if needed)
-uvx --python 3.12 assy
+**First, install `uv` by following the instructions at [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/).**
+
+Then, simply run:
 
-# Or create a virtual environment with a specific Python version
-uv venv --python 3.12
-uv pip install assy
-uv run assy
+```bash
+uv tool install assy
+# Then run with:
+assy
 ```
 
+This will ensure you have a compatible Python version and the latest AutoSubSync installed, regardless of your system Python.
+
 > You can install uv from [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/).
 
----
+
+### Docker Guide
+Thanks to [@IlmariKu](https://github.com/IlmariKu) in PR [#61](https://github.com/denizsafak/AutoSubSync/pull/61), you can run AutoSubSync in a Docker container. This makes it easier to deploy and run AutoSubSync in different environments without worrying about dependencies.
+
+```bash
+# Navigate to the AutoSubSync directory
+cd AutoSubSync
+
+# Create input and output directories
+mkdir -p input output desktop
+
+# Build and run the container
+docker-compose up --build -d
+```
+To access the GUI, open your web browser and go to: [http://localhost:6080](http://localhost:6080)
+
+> [!TIP]
+> For detailed instructions, go the Docker guide:
+> ### **[Go to Docker Guide](DOCKER.md)**
 
 ## `How to use?`
 
@@ -175,6 +200,62 @@ uv run assy
 4. Select output location
 5. Click `Start`
 
+### Command-line interface (`assy-cli`)
+
+For autonomous pipelines, CI/CD, scheduled jobs, and Docker, AutoSubSync ships a
+fully-featured CLI that never starts a Qt event loop or requires a display.
+
+```bash
+# Auto-sync one subtitle (machine-readable output)
+assy-cli sync video.mkv subs.srt -o synced.srt --json
+# {"ok": true, "input": "subs.srt", "output": "synced.srt", "tool": "ffsubsync", ...}
+
+# Shift a subtitle by 1.5 seconds
+assy-cli shift subs.srt 1500 -o shifted.srt
+
+# Batch sync a folder of pairs and continue past failures
+assy-cli batch --folder ./episodes --continue-on-error --json
+
+# Two-folder pairing with explicit output dir
+assy-cli batch --video-dir ./videos --subtitle-dir ./subs -o ./out --json
+
+# Pick a sync engine per call
+assy-cli sync video.mkv subs.srt -t alass
+
+# Add a custom suffix to the output filename
+assy-cli sync video.mkv subs.srt --suffix "_custom"
+
+# Inspect or persist user config
+assy-cli config path
+assy-cli config get sync_tool
+assy-cli config set sync_tool alass
+```
+
+| Subcommand | Purpose |
+|---|---|
+| `sync` | Auto-sync one subtitle to a video or reference subtitle |
+| `shift` | Shift subtitle timing by milliseconds |
+| `batch` | Process many pairs from `--folder`, `--video-dir`+`--subtitle-dir`, or repeated `--pair` |
+| `config` | `get` / `set` / `unset` / `list` / `path` for the user config JSON |
+| `version` | Print version |
+
+**Exit codes:** `0` success · `1` at least one sync failed · `2` usage or config error · `130` SIGINT.
+
+**JSON mode** (`--json`) writes structured results to stdout (one object per sync; for `batch`, NDJSON plus a final `{"summary": ...}` line) while human-readable logs go to stderr. Pipe straight into `jq`:
+
+```bash
+assy-cli sync video.mkv subs.srt --json | jq -r '.output'
+```
+
+**Run from Docker** with no display:
+
+```bash
+docker build -f Dockerfile.cli -t autosubsync-cli .
+docker run --rm -v "$PWD:/data" autosubsync-cli sync /data/video.mkv /data/subs.srt -o /data/out.srt
+```
+
+Or via compose: `docker compose --profile cli run --rm assy-cli sync /data/video.mkv /data/subs.srt`.
+
 ## `Features`
 
 ### Automatic Synchronization
@@ -333,9 +414,9 @@ This eliminates the need to navigate through file browser dialogs for most opera
 
 ### Interface Languages
 
-The application interface is available in 22 languages:
+The application interface is available in 23 languages:
 
-`English`, `Español`, `Deutsch`, `Français`, `Italiano`, `Polski`, `Português`, `Türkçe`, `Tiếng Việt`, `Bahasa Indonesia`, `Bahasa Melayu`, `ไทย`, `Українська`, `Русский`, `中文`, `日本語`, `한국어`, `हिन्दी`, `বাংলা`, `العربية`, `فارسی`, `اردو`
+`English`, `Español`, `Deutsch`, `Français`, `Italiano`, `Polski`, `Português`, `Türkçe`, `Tiếng Việt`, `Bahasa Indonesia`, `Bahasa Melayu`, `ไทย`, `Українська`, `Русский`, `中文`, `繁體中文`, `日本語`, `한국어`, `हिन्दी`, `বাংলা`, `العربية`, `فارسی`, `اردو`
 
 Change the language from `Settings` → `Language`. The interface will update after restarting the application.
 
@@ -358,6 +439,7 @@ Access settings via the gear icon in the **top right** corner.
 | **Keep extracted subtitles** | When synchronizing against embedded video subtitles, keep the extracted subtitle files instead of deleting them after processing. |
 | **Keep converted subtitles** | When subtitle format conversion is required, keep the converted file instead of deleting it after processing. |
 | **Add "tool_" prefix to subtitles** | Add the name of the sync tool (e.g., `ffsubsync_`, `alass_`) to the beginning of the output subtitle filename. |
+| **Add custom suffix for subtitles** | Add a custom suffix to the end of the output subtitle filename (ignored in "Overwrite input subtitle" mode). |
 | **Open config file directory** | Open the folder where configuration files and databases (`processed_items.db`, `library_folders.db`) are stored. |
 | **Open logs directory** | Open the folder where application log files are stored for troubleshooting. |
 | **Keep log records** | When enabled, saves detailed logs of synchronization operations for debugging purposes. |
@@ -369,10 +451,6 @@ Access settings via the gear icon in the **top right** corner.
 
 ---
 
-## `Docker Guide`
-Thanks to [@IlmariKu](https://github.com/IlmariKu), you can now run AutoSubSync in a Docker container. This makes it easier to deploy and run AutoSubSync in different environments without worrying about dependencies.
-> ### [Go to Docker Guide](DOCKER.md)
-
 ## `Contributing`
 I welcome contributions! If you have ideas for new features, improvements, or bug fixes, please fork the repository and submit a pull request.
 
@@ -394,4 +472,53 @@ Thanks to creators of [ffsubsync](https://github.com/smacke/ffsubsync), [autosub
 > [!IMPORTANT]
 > The automatic sync feature is not always perfect. I recommend you to check the subtitles after syncing.
 
+## `How to uninstall?`
+
+Before uninstalling, you may want to cleanup your settings and logs. Open AutoSubSync and go to:
+
+- `Settings` → `Open config file directory` to locate your configuration files and databases. **(You may want to back up these files if you plan to reinstall AutoSubSync later.)**
+- `Settings` → `Open logs directory` to delete log files.
+
+Then, follow the appropriate method below based on how you installed AutoSubSync:
+
+<details>
+<summary><strong>If installed with pip</strong></summary>
+
+```bash
+pip uninstall assy
+```
+</details>
+
+<details>
+<summary><strong>If installed with uv</strong></summary>
+
+```bash
+uv tool uninstall assy
+```
+</details>
+
+<details>
+<summary><strong>If installed from AUR (yay)</strong></summary>
+
+```bash
+yay -R autosubsync-bin
+```
+</details>
+
+<details>
+<summary><strong>If using AppImage or standalone binary</strong></summary>
+
+- **Linux:** Delete the `AppImage` file from your system.
+- **macOS:** Delete the `.app` file from your Applications or wherever you placed it.
+- **Windows:** Delete the folder that contains the extracted files (including the `.exe`).
+</details>
+
+<details>
+<summary><strong>If you created a virtual environment</strong></summary>
+
+Simply remove the virtual environment directory you created for AutoSubSync.
+</details>
+
+---
+
 > Tags: automatic subtitle synchronization, autosubsync, automatic sub sync, subtitle synchronization, resync subtitles, re-sync subtitles, subtitle shifter, subtitle adjuster, subtitle tools, subtitle utilities, synchronize subtitles, adjust subtitle timing, subtitle management, Python subtitle tool, subtitle manipulation, subtitle synchronization script, subtitle sync fixing, subtitle sync fix, fix subtitle sync.

{assy-6.2 → assy-6.4}/README.md

@@ -2,10 +2,12 @@
 
 [![Build Status](https://github.com/denizsafak/AutoSubSync/actions/workflows/app.yml/badge.svg)](https://github.com/denizsafak/AutoSubSync/actions)
 <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
-[![GitHub Release](https://img.shields.io/github/v/release/denizsafak/AutoSubSync)](https://github.com/denizsafak/AutoSubSync/releases/latest)
 [![PyPI version](https://img.shields.io/pypi/v/assy)](https://pypi.org/project/assy/)
+[![GitHub Release](https://img.shields.io/github/v/release/denizsafak/AutoSubSync)](https://github.com/denizsafak/AutoSubSync/releases/latest)
 [![Operating Systems](https://img.shields.io/badge/os-windows%20%7C%20linux%20%7C%20macos%20-blue)](https://github.com/denizsafak/AutoSubSync/releases/latest)
-[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/denizsafak/AutoSubSync/total?color=blue)](https://github.com/denizsafak/AutoSubSync/releases/latest)
+![Pepy Total Downloads](https://img.shields.io/pepy/dt/assy?label=downloads%20(pypi)&color=blue)
+[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/denizsafak/AutoSubSync/total?color=blue&label=downloads%20(github))](https://github.com/denizsafak/AutoSubSync/releases/latest)
+
 
 AutoSubSync is a user-friendly tool that automatically synchronizes your subtitles with your videos using powerful tools such as [ffsubsync](https://github.com/smacke/ffsubsync), [autosubsync](https://github.com/oseiskar/autosubsync) and [alass](https://github.com/kaegi/alass). It also lets you manually adjust the subtitle timings. Just drag and drop your files, and let AutoSubSync do the rest, making subtitle alignment both simple and efficient.
 
@@ -55,7 +57,9 @@ yay -S autosubsync-bin
 > ```
 
 ### PyPI (All Platforms)
-You can install AutoSubSync using either pip or uv (a fast Python package manager) on any platform with Python 3.10+:
+[![PyPi Python Versions](https://img.shields.io/pypi/pyversions/assy)](https://pypi.org/project/assy/)
+
+You can install AutoSubSync using either pip or uv (a fast Python package manager) on any platform with Python 3.10 - 3.13:
 
 
 ```bash
@@ -66,7 +70,7 @@ pip install assy
 <summary><strong>With uv (click to expand)</strong></summary>
 
 ```bash
-uv pip install --system assy
+uv tool install assy
 ```
 
 </details>
@@ -80,7 +84,7 @@ pip install assy[torch]
 <summary><strong>With uv (click to expand)</strong></summary>
 
 ```bash
-uv pip install --system assy[torch]
+uv tool install assy[torch]
 ```
 
 </details>
@@ -90,23 +94,44 @@ uv pip install --system assy[torch]
 assy
 ```
 
+
 #### If your system Python is not compatible (e.g., macOS with older Python):
 
-If your system Python version is below 3.10 or above 3.13, you can use `uv` to automatically download a compatible Python version and run AutoSubSync:
+If your system Python version is below 3.10 or above 3.13, the recommended solution is to use [`uv`](https://docs.astral.sh/uv/getting-started/installation/) to install and run AutoSubSync with a compatible Python version automatically.
 
-```bash
-# One-liner to run AutoSubSync with a compatible Python (downloads Python 3.12 if needed)
-uvx --python 3.12 assy
+**First, install `uv` by following the instructions at [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/).**
+
+Then, simply run:
 
-# Or create a virtual environment with a specific Python version
-uv venv --python 3.12
-uv pip install assy
-uv run assy
+```bash
+uv tool install assy
+# Then run with:
+assy
 ```
 
+This will ensure you have a compatible Python version and the latest AutoSubSync installed, regardless of your system Python.
+
 > You can install uv from [astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/).
 
----
+
+### Docker Guide
+Thanks to [@IlmariKu](https://github.com/IlmariKu) in PR [#61](https://github.com/denizsafak/AutoSubSync/pull/61), you can run AutoSubSync in a Docker container. This makes it easier to deploy and run AutoSubSync in different environments without worrying about dependencies.
+
+```bash
+# Navigate to the AutoSubSync directory
+cd AutoSubSync
+
+# Create input and output directories
+mkdir -p input output desktop
+
+# Build and run the container
+docker-compose up --build -d
+```
+To access the GUI, open your web browser and go to: [http://localhost:6080](http://localhost:6080)
+
+> [!TIP]
+> For detailed instructions, go the Docker guide:
+> ### **[Go to Docker Guide](DOCKER.md)**
 
 ## `How to use?`
 
@@ -132,6 +157,62 @@ uv run assy
 4. Select output location
 5. Click `Start`
 
+### Command-line interface (`assy-cli`)
+
+For autonomous pipelines, CI/CD, scheduled jobs, and Docker, AutoSubSync ships a
+fully-featured CLI that never starts a Qt event loop or requires a display.
+
+```bash
+# Auto-sync one subtitle (machine-readable output)
+assy-cli sync video.mkv subs.srt -o synced.srt --json
+# {"ok": true, "input": "subs.srt", "output": "synced.srt", "tool": "ffsubsync", ...}
+
+# Shift a subtitle by 1.5 seconds
+assy-cli shift subs.srt 1500 -o shifted.srt
+
+# Batch sync a folder of pairs and continue past failures
+assy-cli batch --folder ./episodes --continue-on-error --json
+
+# Two-folder pairing with explicit output dir
+assy-cli batch --video-dir ./videos --subtitle-dir ./subs -o ./out --json
+
+# Pick a sync engine per call
+assy-cli sync video.mkv subs.srt -t alass
+
+# Add a custom suffix to the output filename
+assy-cli sync video.mkv subs.srt --suffix "_custom"
+
+# Inspect or persist user config
+assy-cli config path
+assy-cli config get sync_tool
+assy-cli config set sync_tool alass
+```
+
+| Subcommand | Purpose |
+|---|---|
+| `sync` | Auto-sync one subtitle to a video or reference subtitle |
+| `shift` | Shift subtitle timing by milliseconds |
+| `batch` | Process many pairs from `--folder`, `--video-dir`+`--subtitle-dir`, or repeated `--pair` |
+| `config` | `get` / `set` / `unset` / `list` / `path` for the user config JSON |
+| `version` | Print version |
+
+**Exit codes:** `0` success · `1` at least one sync failed · `2` usage or config error · `130` SIGINT.
+
+**JSON mode** (`--json`) writes structured results to stdout (one object per sync; for `batch`, NDJSON plus a final `{"summary": ...}` line) while human-readable logs go to stderr. Pipe straight into `jq`:
+
+```bash
+assy-cli sync video.mkv subs.srt --json | jq -r '.output'
+```
+
+**Run from Docker** with no display:
+
+```bash
+docker build -f Dockerfile.cli -t autosubsync-cli .
+docker run --rm -v "$PWD:/data" autosubsync-cli sync /data/video.mkv /data/subs.srt -o /data/out.srt
+```
+
+Or via compose: `docker compose --profile cli run --rm assy-cli sync /data/video.mkv /data/subs.srt`.
+
 ## `Features`
 
 ### Automatic Synchronization
@@ -290,9 +371,9 @@ This eliminates the need to navigate through file browser dialogs for most opera
 
 ### Interface Languages
 
-The application interface is available in 22 languages:
+The application interface is available in 23 languages:
 
-`English`, `Español`, `Deutsch`, `Français`, `Italiano`, `Polski`, `Português`, `Türkçe`, `Tiếng Việt`, `Bahasa Indonesia`, `Bahasa Melayu`, `ไทย`, `Українська`, `Русский`, `中文`, `日本語`, `한국어`, `हिन्दी`, `বাংলা`, `العربية`, `فارسی`, `اردو`
+`English`, `Español`, `Deutsch`, `Français`, `Italiano`, `Polski`, `Português`, `Türkçe`, `Tiếng Việt`, `Bahasa Indonesia`, `Bahasa Melayu`, `ไทย`, `Українська`, `Русский`, `中文`, `繁體中文`, `日本語`, `한국어`, `हिन्दी`, `বাংলা`, `العربية`, `فارسی`, `اردو`
 
 Change the language from `Settings` → `Language`. The interface will update after restarting the application.
 
@@ -315,6 +396,7 @@ Access settings via the gear icon in the **top right** corner.
 | **Keep extracted subtitles** | When synchronizing against embedded video subtitles, keep the extracted subtitle files instead of deleting them after processing. |
 | **Keep converted subtitles** | When subtitle format conversion is required, keep the converted file instead of deleting it after processing. |
 | **Add "tool_" prefix to subtitles** | Add the name of the sync tool (e.g., `ffsubsync_`, `alass_`) to the beginning of the output subtitle filename. |
+| **Add custom suffix for subtitles** | Add a custom suffix to the end of the output subtitle filename (ignored in "Overwrite input subtitle" mode). |
 | **Open config file directory** | Open the folder where configuration files and databases (`processed_items.db`, `library_folders.db`) are stored. |
 | **Open logs directory** | Open the folder where application log files are stored for troubleshooting. |
 | **Keep log records** | When enabled, saves detailed logs of synchronization operations for debugging purposes. |
@@ -326,10 +408,6 @@ Access settings via the gear icon in the **top right** corner.
 
 ---
 
-## `Docker Guide`
-Thanks to [@IlmariKu](https://github.com/IlmariKu), you can now run AutoSubSync in a Docker container. This makes it easier to deploy and run AutoSubSync in different environments without worrying about dependencies.
-> ### [Go to Docker Guide](DOCKER.md)
-
 ## `Contributing`
 I welcome contributions! If you have ideas for new features, improvements, or bug fixes, please fork the repository and submit a pull request.
 
@@ -351,4 +429,53 @@ Thanks to creators of [ffsubsync](https://github.com/smacke/ffsubsync), [autosub
 > [!IMPORTANT]
 > The automatic sync feature is not always perfect. I recommend you to check the subtitles after syncing.
 
+## `How to uninstall?`
+
+Before uninstalling, you may want to cleanup your settings and logs. Open AutoSubSync and go to:
+
+- `Settings` → `Open config file directory` to locate your configuration files and databases. **(You may want to back up these files if you plan to reinstall AutoSubSync later.)**
+- `Settings` → `Open logs directory` to delete log files.
+
+Then, follow the appropriate method below based on how you installed AutoSubSync:
+
+<details>
+<summary><strong>If installed with pip</strong></summary>
+
+```bash
+pip uninstall assy
+```
+</details>
+
+<details>
+<summary><strong>If installed with uv</strong></summary>
+
+```bash
+uv tool uninstall assy
+```
+</details>
+
+<details>
+<summary><strong>If installed from AUR (yay)</strong></summary>
+
+```bash
+yay -R autosubsync-bin
+```
+</details>
+
+<details>
+<summary><strong>If using AppImage or standalone binary</strong></summary>
+
+- **Linux:** Delete the `AppImage` file from your system.
+- **macOS:** Delete the `.app` file from your Applications or wherever you placed it.
+- **Windows:** Delete the folder that contains the extracted files (including the `.exe`).
+</details>
+
+<details>
+<summary><strong>If you created a virtual environment</strong></summary>
+
+Simply remove the virtual environment directory you created for AutoSubSync.
+</details>
+
+---
+
 > Tags: automatic subtitle synchronization, autosubsync, automatic sub sync, subtitle synchronization, resync subtitles, re-sync subtitles, subtitle shifter, subtitle adjuster, subtitle tools, subtitle utilities, synchronize subtitles, adjust subtitle timing, subtitle management, Python subtitle tool, subtitle manipulation, subtitle synchronization script, subtitle sync fixing, subtitle sync fix, fix subtitle sync.

assy-6.4/main/VERSION

@@ -0,0 +1 @@
+6.4

{assy-6.2 → assy-6.4}/main/call_autosubsync.py

@@ -4,6 +4,7 @@ import runpy, os, threading
 import logging
 from multiprocessing import freeze_support
 from utils import get_resource_path
+import compat  # Shim for pkg_resources (removed in Python 3.14+)
 
 # Monkey-patch subprocess.Popen to always use CREATE_NO_WINDOW on Windows
 import subprocess

{assy-6.2 → assy-6.4}/main/call_ffsubsync.py

@@ -1,7 +1,7 @@
 import sys
 import platform
 from multiprocessing import freeze_support
-from ffsubsync.ffsubsync import main
+import compat  # Shim for pkg_resources (removed in Python 3.14+)
 
 # Monkey-patch subprocess.Popen to always use CREATE_NO_WINDOW on Windows
 import subprocess
@@ -18,6 +18,14 @@ if platform.system() == "Windows":
     subprocess.Popen = _patched_popen
 
 
+def _load_ffsubsync():
+    try:
+        from ffsubsync.ffsubsync import main as ffsubsync_main
+        return ffsubsync_main, None
+    except Exception as e:
+        return None, e
+
+
 def cli_entry(args=None):
     """
     Entry point for module-based execution. Accepts a list of arguments (excluding script name),
@@ -26,15 +34,26 @@ def cli_entry(args=None):
     """
     import sys as _sys
 
+    ffsubsync_main, import_error = _load_ffsubsync()
+    if ffsubsync_main is None:
+        msg = (
+            "ffsubsync is not available. Install it with 'pip install ffsubsync' "
+            "or 'pip install assy' to use this sync tool."
+        )
+        print(msg, file=_sys.stderr)
+        if import_error:
+            print(f"Import error: {import_error}", file=_sys.stderr)
+        return 1
+
     old_argv = _sys.argv
     if args is not None:
         _sys.argv = [old_argv[0]] + args
     try:
-        return main()
+        return ffsubsync_main()
     finally:
         _sys.argv = old_argv
 
 
 if __name__ == "__main__":
     freeze_support()  # fix https://github.com/pyinstaller/pyinstaller/issues/4104
-    sys.exit(main())
+    sys.exit(cli_entry())