A simple utility module for Subtitles.
Subdesc requires mkvtoolnix
and ffmpeg
for working with mkv files. You can install them with the following commands:
brew install mkvtoolnix
brew install ffmpeg
Then, Just run pip install subdesc
You can use Subdesc as a command line tool as follows. subd
can be replaced with subdesc
as well.
When you want to attach subtitle to your mkv file as softsub:
subd mux <video_file> <subtitle_file> <output_file>
When your subtitle file has weird encoding and it's not human-readable:
subd normalize <subtitle_file>
When your subtitle file is out of sync with your video file:
subd sync <source_file> <subtitle_file>
source_file
could be a mkv file or another subtitle file
When you have OCD like me and you want to apply all of the above commands at once:
subd magic <video_file> <subtitle_file>
This will overwrite video file with the new one.
Subdesc is still in development, and it's not stable yet.
It could delete your input files in case of interruption. So please take a backup and use it at your own risk.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.