← Commit history

skill: narrated wiki videos get captions free (gang-takes vtt + chapters, ::adom-video); ships with the next release

John Lauer ·8aa126de98 ·7d ago ·parent f308b80
1 file changed +13
skills/adom-tts/SKILL.md+13
@@ -120,6 +120,19 @@ adom-tts say "Quickly" --out q.mp3 --rate +15% --play adom-tts say "Generic sentence" --out g.mp3 --no-pronunciations --play ``` +## Narrating a video for the wiki: the captions come free++When adom-tts voices a video, you already have the exact words and where each clip lands in the cut,+which is a captions file. Do not ship a narrated wiki video without one:++- Built with **gang-takes** (adom/adom-video-post): it writes `final.vtt` from the narration text and+  `final.chapters.json` from the segment labels, and prints the `::adom-video{...}` embed line+  (pass `--wiki-path /OWNER/SLUG/render/FOLDER` to get real paths and a private-page manifest).+- Narration placed some other way: one cue per sentence, start = where its clip starts in the cut,+  end = start + the clip's duration (`ffprobe` the trimmed mp3), the text exactly as you sent it to `say`.+- Embed with the `::adom-video` wiki widget (adom/widgets) and pass `captions=` and `chapters=`;+  readers press C for captions. See **demo-video-publishing** for the embed rules.+ ## Live demos: pre-cache a script, cue one marker at a time  When you narrate a demo in lockstep with what you show on screen, do NOT `say`