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 You have to include $HOME/.local/bin to your $PATH. Simply add export PATH=”$HOME/.local/bin:$PATH” to .bashrc.
`bash python setup.py install --user `
### Install for development `bash pip install --prefix=$(python -m site --user-base) --editable . `
NOTE: –prefix=$(python3 -m site –user-base) is a workaround for a known [setuptools issue](https://github.com/pypa/setuptools/issues/3063)
## Usage
### Merge two .srt files `bash submerge --subtitles subtitle1.srt subtitle2.srt --output dualsub.srt `
### Create a dual subtitles by extracting embedded subtitles from a video file `bash submerge --video video.mkv --language eng ger --output dualsub.srt `
### Merge subtitles for all videos in a directory `bash submerge --global --language eng ger --directory path/to/series `
### Check for available subtitles `bash 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 `bash python scripts/run_tests.py --unit `
### Run integration tests `bash python scripts/run_tests.py --integration `
### Run lint tests `bash python scripts/run_tests.py --lint `
### Or run periodically with watch `bash watch python scripts/run_tests.py --all `
## [Design doc](https://docs.google.com/document/d/1iSxnH16rYWxvE4ppYtPJ-oHzsmoGimXYdd19pA1gVyY)
## License [GPLv3](https://choosealicense.com/licenses/gpl-3.0/)
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
Built Distribution
Hashes for submerger-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b7e9542da85089e1a0cd0e35fa17e9729067598dcaf66dff3dd8a2dc8e60e577 |
|
MD5 | 01cda951f37d7379515fbc61611000cc |
|
BLAKE2b-256 | 97d835b48bddb070755d4980d45881814fc1a1484600651a738764b2af15cca4 |