submerger 2023.5.13

Subtitle merging tool

Submerger

Watching movies in a foreign language with dual subtitles is a good way to learn that language. However, most of the subtitles are in a single language. This project aims to overcome that barrier by providing the functionality to create dual subtitles by merging two separate subtitle files.

System requirements

Python >= 3.10

Install

pip install submerger

Install for development

You have to include $HOME/.local/bin to your $PATH. Simply add export PATH="$HOME/.local/bin:$PATH" to .bashrc.

pip install --prefix=$(python -m site --user-base) --editable .

NOTE: --prefix=$(python3 -m site --user-base) is a workaround for a known setuptools issue

Usage

Merge two .srt files

submerge --subtitles subtitle1.srt subtitle2.srt --output dualsub.srt

Create a dual subtitles by extracting embedded subtitles from a video file

submerge --video video.mkv --language eng ger --output dualsub.srt

Merge subtitles for all videos in a directory

submerge --global --language eng ger --directory path/to/series

Check for available subtitles

ffprobe -loglevel error -print_format json video.mkv -print_format json -show_entries "stream=index:stream_tags=language" -select_streams s

Testing

Run unit tests

python scripts/run_tests.py --unit

Run integration tests

python scripts/run_tests.py --integration

Run lint tests

python scripts/run_tests.py --lint

Or run periodically with watch

watch python scripts/run_tests.py --all

License

GPLv3