Subtitle Toolkit

{'type': 'object', 'required': ['content'], 'properties': {'content': {'type': 'string', 'description': 'The full subtitle file text.'}, 'max_cps': {'type': 'number', 'description': 'Max characters per second. Default 20.'}, 'max_line_length': {'type': 'number', 'description': 'Max characters per line. Default 42.'}, 'max_duration_seconds': {'type': 'number', 'description': 'Maximum cue duration in seconds. Default 7.'}, 'min_duration_seconds': {'type': 'number', 'description': 'Minimum cue duration in seconds. Default 0.833 (Netflix 5/6s).'}}}

{'type': 'object', 'required': ['content'], 'properties': {'to': {'enum': ['srt', 'vtt'], 'type': 'string', 'description': 'Output format. Default: same as the input.'}, 'content': {'type': 'string', 'description': 'The full subtitle file text.'}, 'drop_empty': {'type': 'boolean', 'description': 'Drop cues that become empty after cleaning. Default true.'}, 'remove_tags': {'type': 'boolean', 'description': 'Strip HTML/WebVTT tags and ASS override codes. Default true.'}, 'drop_duplicates': {'type': 'boolean', 'description': 'Drop cues whose text was already seen. Default false.'}, 'remove_sound_cues': {'type': 'boolean', 'description': 'Strip [Music], [Applause], ♪ ... ♪ and similar. Default true.'}, 'remove_speaker_labels': {'type': 'boolean', 'description': 'Strip leading "SPEAKER:" prefixes. Default false — enable only if you want them gone.'}}}

{'type': 'object', 'required': ['content', 'to'], 'properties': {'to': {'enum': ['srt', 'vtt', 'ass', 'csv', 'text'], 'type': 'string', 'description': 'Target format. `text` = plain transcript, one line per cue, no timecodes.'}, 'from': {'enum': ['auto', 'srt', 'vtt', 'ass', 'sbv', 'ttml'], 'type': 'string', 'description': 'Source format (default "auto" = detect).'}, 'dedupe': {'type': 'boolean', 'description': 'Only for to="text": collapse consecutive identical lines (rolling-caption transcripts repeat lines). Default false.'}, 'content': {'type': 'string', 'description': 'The full subtitle file text.'}}}

{'type': 'object', 'required': ['content'], 'properties': {'twice': {'type': 'boolean', 'description': 'Set true when the text was mis-decoded twice (nested mojibake). Default false.'}, 'content': {'type': 'string', 'description': 'The garbled subtitle text.'}, 'read_as': {'enum': ['auto', 'cp1252', 'cp1251'], 'type': 'string', 'description': 'Which encoding the file was wrongly read as. Default "auto" (tries cp1252 then cp1251).'}}}

{'type': 'object', 'required': ['content', 'append_content'], 'properties': {'to': {'enum': ['srt', 'vtt'], 'type': 'string', 'description': 'Output format. Default: same as the input.'}, 'content': {'type': 'string', 'description': 'The first subtitle file text.'}, 'gap_seconds': {'type': 'number', 'description': 'Extra gap between the two tracks, in seconds. Default 0.'}, 'append_content': {'type': 'string', 'description': 'The subtitle file text to append.'}}}

{'type': 'object', 'required': ['content'], 'properties': {'ratio': {'type': 'number', 'description': 'Scale all timings by this factor (new = old x ratio). e.g. 1.0427 for a 25→23.976 fps fix.'}, 'to_fps': {'type': 'number', 'description': 'The frame rate of the actual video (used with from_fps).'}, 'content': {'type': 'string', 'description': 'The full subtitle file text.'}, 'from_fps': {'type': 'number', 'description': 'The frame rate the subtitles were authored for (used with to_fps).'}, 'offset_seconds': {'type': 'number', 'description': 'Shift every cue by this many seconds. Negative = earlier. e.g. -2.5'}}}

{'type': 'object', 'required': ['content', 'at'], 'properties': {'at': {'type': 'string', 'description': 'Split point. Accepts "45:00", "1:02:03", "90" (seconds) or "1:02:03.500".'}, 'to': {'enum': ['srt', 'vtt'], 'type': 'string', 'description': 'Output format. Default: same as the input.'}, 'part': {'enum': ['a', 'b'], 'type': 'string', 'description': 'Which half to return. Default "a" (before the split point).'}, 'content': {'type': 'string', 'description': 'The full subtitle file text.'}}}

{'type': 'object', 'required': ['content'], 'properties': {'content': {'type': 'string', 'description': 'Plain text, one caption per line. Blank lines are skipped.'}, 'start_seconds': {'type': 'number', 'description': 'Timecode of the first cue, in seconds. Default 0.'}, 'duration_seconds': {'type': 'number', 'description': 'Seconds each cue stays on screen. Default 2.5.'}, 'max_chars_per_cue': {'type': 'number', 'description': 'Split longer lines into several cues at word boundaries. Default 0 = never split.'}}}