Subtitle merging tool
Project description
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
submerger-2023.5.13.tar.gz
(21.6 kB
view hashes)
Built Distribution
Close
Hashes for submerger-2023.5.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ca65b08b418c649eb048da5ea8c6865f94a306d02306f51104890d79546abf3c |
|
MD5 | a93b1cc8fb619983385dd15689f10ba8 |
|
BLAKE2b-256 | 601f0a9ef17d3e2d50e0bc8c796020c375c5bc18b9eba74fc4de5eedcd99c1e5 |