Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 2.02 KB

File metadata and controls

47 lines (33 loc) · 2.02 KB

🎬 SubtitleFusion

A simple desktop tool to extract embedded subtitles from your videos and merge external subtitles back into them — batch process a whole folder in a few clicks.

✨ Why this tool?

Point it at your video files, and SubtitleFusion either pulls out every subtitle track already inside them, or automatically matches subtitle files to the right videos and merges them in — no manual pairing, no command line required.

🚀 Quick start

System Command
Windows Run run_windows.bat
Linux / macOS Run run_unix.sh

On first run, make sure the required library (PySide6) and ffmpeg/ffprobe are installed (see Requirements below).

To run manually:

python -m pip install -r requirements.txt
python subtitle_fusion.py

🧩 Key features

  • Extract embedded subtitles — pull every subtitle track out of your movies and series in one batch, with filters for all tracks, a single selected track, the default track, or Arabic/English only
  • Merge subtitles with video — automatically match subtitle files to their videos and merge them all at once
  • Two merge methods — soft mux (fast, no re-encoding) or burn-in (hard-coded onto the picture)
  • Built-in fallback extractor for subtitle tracks that ffmpeg can't read directly
  • Choose the output format (SRT, ASS, or WebVTT) and destination — next to the original file or a custom folder
  • Options to keep, delete, or replace the original file after a successful merge
  • Filename suffixes and language-code tagging to avoid overwriting the source file
  • Live progress bar, per-file status, and a detailed log panel
  • Light and dark theme, with a full English/Arabic interface toggle

⚙️ Requirements

  • Python 3.9 or newer
  • PySide6 (for the graphical interface)
  • ffmpeg and ffprobe, available on your PATH (or their paths set from the Settings page)

📁 Supported formats

  • Video: MKV, MP4, M4V, MOV, AVI, WMV, FLV, WEBM, MPG, and more
  • Subtitles: SRT, ASS, SSA, VTT, SUB, IDX, SUP, TTML, DFXP