Convert TTML subtitles used by Netflix, HBO, CMore and others to SRT format.
Note: ttml2srt is not a full-featured TTML-to-SRT converter and only works on a small subset of TTML documents. Namely, documents that follow the formats seen on the aforementioned streaming services.
positional arguments:
ttml-file TTML subtitle file
output-file file to write resulting SRT to
optional arguments:
-h, --help show this help message and exit
-s [ms], --shift [ms]
shift
-f [fps], --fps [fps]
frames per second (default: 23.976)
--t-dur [sec] target duration
--s-dur [sec] source duration
Simple conversion:
./ttml2srt.py subtitle_from_netflix.xml > subtitle.srt
or
./ttml2srt.py subtitle_from_netflix.xml subtitle.srt
Shift everything forward by 2 secs:
./ttml2srt.py -s 2000 subtitle_from_netflix.xml > subtitle.srt
Convert with specific frame rate (only has an effect when input timestamps have frames):
./ttml2srt.py -f 25 subtitle_from_hbo_nordic.xml > subtitle.srt
You'll probably run into a situation where your target is playing at either slower or faster speed compared to a streaming service. You can scale timestamps to fit a source to a target by picking the same frame from both the target and source and comparing the timestamp.
Here's an example cmd for when the first piece of dialogue from a streaming service is starting two seconds behind the target audio and where a frame towards the end has a timestamp of 00:15:39 (939s) in the target and 00:16:23 (983s) in the source:
./ttml2srt.py -s -2000 --t-dur 939 --s-dur 983 subtitle.xml
Run tests:
python3 tests/test01.py