Subtitle Srt Export
Export a standard .srt subtitle file from the MEASURED word timings in a job's input.json (written by elevenlabs-tts). Flattens the per-word timings into readable cues (max ~3.5s / ~10 words per cue, breaking on sentence punctuation) and writes /subtitles.srt for upload to YouTube and other platforms. No API call. Re-runnable. Does not modify input.json.
subtitle-srt-export
Turn the measured word-level timings into a ready-to-upload .srt file. No API
call, never mutates input.json, safe to re-run.
Why this skill exists
elevenlabs-tts writes accurate per-word timings into input.json's
subtitles[].words[]. Those word timings are perfect for an on-screen karaoke
render but are too granular for a subtitle file — a platform wants a handful of
readable cues, not one cue per word. This skill groups the words into cues and
emits valid SRT.
Inputs
A job folder path whose input.json already contains measured word timings
(run elevenlabs-tts first). Each word is
{word, start, end} under subtitles[].words[].
Usage
bash skills/subtitle-srt-export/scripts/export_srt.sh <job-folder>
Example (the bundled demo job):
bash skills/subtitle-srt-export/scripts/export_srt.sh examples/demo-job
Cue grouping rules
A new cue starts when any of these is true:
- the previous word ended a sentence (
.,?,!) - the current cue would exceed ~3.5 seconds
- the current cue would exceed ~10 words
Tune the $maxdur / $maxwords constants at the top of the jq block to taste.
Output
Writes <job>/subtitles.srt and prints:
Wrote <job>/subtitles.srt with <N> cues from <M> words
On a missing-timings precondition failure it prints an ERROR: line and exits
non-zero — run elevenlabs-tts first.
- Downloads
- Security audit
- Pass
- Last updated
- 4mo ago
- Current version
- v1.0.0
- License
- MIT-0
