gosavetool-subtitles

Parse, convert, shift and repair SRT and WebVTT subtitles in Python. No dependencies, typed, with a command line tool.

Handy after speech-to-text: turn Whisper's SRT into WebVTT for the web, move captions that run late, and clean up overlaps.

Made by GoSaveTool. Prefer a visual editor? The VTT Subtitle Generator times captions against the video in your browser.

Install

pip install gosavetool-subtitles

Convert SRT to WebVTT

from pathlib import Path
from gosavetool_subtitles import convert

Path("movie.vtt").write_text(convert(Path("movie.srt").read_text("utf-8"), "vtt"), "utf-8")

Work with cues

from gosavetool_subtitles import parse, shift, repair, to_srt

cues = parse(text)              # [Cue(start=1000, end=3500, text='Hello', settings=''), ...]
later = shift(cues, 1500)       # every cue 1.5 s later (negative = earlier)
fixed, changes = repair(cues)   # sort, fix overlaps and bad end times, drop empty cues
Path("out.srt").write_text(to_srt(fixed), "utf-8")

Command line

gosavetool-subtitles convert movie.srt --to vtt
gosavetool-subtitles shift movie.srt -1.5
gosavetool-subtitles repair movie.vtt
gosavetool-subtitles info movie.srt

-o out.vtt writes to another file, --stdout prints the result. python -m gosavetool_subtitles works too.

Related

• Auto Captions Generator: captions from speech, in the browser
• Video to Text: transcribe a video
• JavaScript: @gosavetool/subtitles · PHP: gosavetool/subtitles

License

MIT