style-captions

Purpose

Design caption styles and render caption overlay variants for video outputs.

Supports two output paths:

ASS subtitle file — scripts/make_subtitles.py generates a .ass file from word timestamps (JSON) with karaoke-style word highlighting. Pass --preset <id> to load a named editorial style from references/caption-style-presets.json.
Caption PNG — scripts/make_caption_pngs.py renders rounded-pill caption images (used for music-only or silent-demo title cards).
Loading dots PNG sequence — scripts/make_loading_dots.py renders a 5-frame dots animation.

Named caption presets align with CREATOR_GRAMMAR.md §7 and the source of truth JSON at references/caption-style-presets.json: