From 3b21c3c52b10f6cac7ccc51e8b14b570a979ef6c Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 12 Jun 2026 21:00:41 +0000 Subject: [PATCH] docs: add burned-in video subtitles example to README Show how to generate karaoke-style captions with -o srt / --chars-per-caption and burn them into a video with ffmpeg, noting the pipe-based soft-subtitle alternative. https://claude.ai/code/session_013y928a4tVJdR5qUaK6CFoH --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index 9279a73f..bacca957 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,13 @@ assembly transcribe "https://podcasts.apple.com/us/podcast/id1516093381" --speak | assembly --sandbox speak --out episode.wav ``` +**Burn karaoke subtitles into a music video** — `-o srt` prints captions to stdout, and `--chars-per-caption` keeps the lines short so they flip with the vocals; ffmpeg renders them onto the video (`-f srt -i pipe:` muxes a toggleable soft-subtitle track instead, no re-encode): + +```sh +assembly transcribe video.mp4 -o srt --chars-per-caption 24 > lyrics.srt +ffmpeg -i video.mp4 -vf "subtitles=lyrics.srt:force_style='Fontsize=28,PrimaryColour=&H00FFFF&'" karaoke.mp4 +``` + **Keep a live to-do list from your mic** — `llm -f` re-runs the prompt over the growing transcript, updating in place: ```sh