Auto Subtitle Plus (Enhanced Fork)

This project is a clean and improved fork of the original repository by Sectumsempra82.
Goal: simplify usage, improve stability, and add automatic translation.

Bu araç, videolarınız için otomatik altyazı oluşturabilir, altyazıları istediğiniz dile çevirebilir
veya hem orijinal hem de çevrilmiş altyazıyı (çift dil; örneğin türkçe-ingilizce altyazı) aynı anda üretebilir.

---

What's New in This Version

• Automatic subtitle translation (Google Translate backend)
• Disable translation with --translate-off
• Target language selection via --translate-to tr|fr|...
• Batch translation & multithreading for speed
• Clear, grouped CLI (Output, Language, Performance, Advanced)
• Stable Whisper integration for robust transcription
• Subtitled videos saved with _subtitled.mp4
• Cleaner logs and small performance tweaks

---

Installation

Supports Python 3.7 – 3.11.

Quick install (from GitHub):

pip install git+https://github.com/seyithokelek/auto-subtitle-plus

Also install ffmpeg (if not already installed):

# Ubuntu/Debian
sudo apt install ffmpeg
# macOS (Homebrew)
brew install ffmpeg
# Windows (Chocolatey)
choco install ffmpeg

---

Quick Usage

Generate subtitles only (default)

By default, this creates an .srt next to your video (it does not embed unless you ask for it):

auto_subtitle_plus video_name.*

This produces video_name.srt.

Generate and embed subtitles into video

auto_subtitle_plus video.mp4 --output-video

Outputs video_subtitled.mp4.

Translate subtitles to another language

auto_subtitle_plus video.mp4 --translate-to fr --output-srt

Keep original language (no translation)

auto_subtitle_plus video.mp4 --translate-off --output-srt

---

Batch Processing Examples

Process all MP4 files in the current directory (SRT only)

auto_subtitle_plus *.mp4 --output-srt

Process multiple formats in one go

auto_subtitle_plus *.mp4 *.mkv *.mov --output-srt

Embed subtitles for multiple files

auto_subtitle_plus *.mp4 --output-video

Creates *_subtitled.mp4 for each input that produced subtitles.

Translate all videos to Turkish and save SRT

auto_subtitle_plus *.mp4 --translate-to tr --output-srt

(Linux/macOS) Recurse into subfolders (Bash)

shopt -s globstar nullglob
auto_subtitle_plus **/*.mp4 --output-srt

(Windows PowerShell) Recurse into subfolders

Get-ChildItem -Recurse -Include *.mp4,*.mkv,*.mov | ForEach-Object {
  auto_subtitle_plus $_.FullName --output-srt
}

---

CPU/GPU & Performance

Force CPU

auto_subtitle_plus video.mp4 --device cpu

Use GPU (CUDA)

auto_subtitle_plus video.mp4 --device cuda

Ensure your PyTorch installation has CUDA support. If CUDA is unavailable, the tool falls back to CPU.

Tune parallelism and throughput

• Audio extraction workers (CPU processes): --extract-workers 4
• Translation batch size: --batch-size 20
• Translation threads: --max-workers 8

Example (batch SRT with tuned settings):

auto_subtitle_plus *.mp4 --output-srt --batch-size 20 --max-workers 8 --extract-workers 4

Larger models on GPU

auto_subtitle_plus *.mp4 --model large --device cuda --output-srt

---

Show All Options

auto_subtitle_plus --help

---

License

MIT. See LICENSE.

This fork acknowledges and builds upon the original work by Sectumsempra82 and its README (provided as README_org.md).