Skip to main content

cleya animated-captions

Add karaoke-style animated captions (macOS only, requires Whisper)

Platform: macOS only (Vision/AVFoundation)
Cost: slow — transcription + GPU text rendering

cleya animated-captions --input video.mp4 --language en

Options

FlagWhat it does
--inputPath to input videorequired · string
--outputOutput file pathstring · default <input>_karaoke.<ext>
--languageLanguage code (e.g. en, es, fr, de)string
--whisper-pathPath to Whisper binarystring · default whisper
--modelWhisper modelstring · default base · one of base, small, medium, large
--font-sizeFont size in pixelsstring · default 48
--font-colorBase text colorstring · default white
--highlight-colorActive word highlight colorstring · default yellow
--positionCaption positionstring · default bottom · one of top, center, bottom
--words-per-groupWords per caption group (2-7)string · default 4
--overwriteOverwrite output file if it existsboolean

Category: author — create media from specs (scene DSL, cards, titles, captions, voiceover, capture)

Generated from the toolkit

Generated from cleya capabilities, the toolkit's own manifest, so it cannot drift. Run cleya animated-captions --help for the same information in your terminal.