captions

Topics in the source

• Captions & subtitles
• CRITICAL: use --clean for captions
• Export a subtitle file (no burn-in)
• Burn captions into the video
• Styling
• Gotchas

Full Production Studio note: this skill drives the toolkit in agamm/video-agent. Clone that repo and run your agent inside it for the scripts/paths below to work; the guidance itself is usable anywhere. Two outputs, one transcription engine (mlx-whisper, same as transcribe): Sidecar file (.srt / .vtt) — for YouTube/Vimeo upload, re-editing, or other tools. Burned-in — pixels baked into the video (social clips where the player won't show a subtitle track). Rendered via PIL → ffmpeg overlay (mise ffmpeg lacks drawtext). This is the opposite of filler-removal. Whisper is verbatim by default here (keeps um/uh) because filler-removal needs them. Subtitles do not — viewers don't want "um, uh" on screen. Always pass --clean when transcribing for captions: Upload subs.srt alongside the video, or hand-edit it (fix names/typos, retime) and burn that edited file — see below. --srt accepts both .srt and .vtt. When --srt is given, no transcription runs — it just burns the file you pass, so this is also how you re-burn after editing. --size px (default 5% of frame height) · --color white|yellow|red|black --position bottom (default) | top | center --no-box removes the semi-transparent legibility

This is an excerpt. Refer to the complete source and its current requirements.