# Burned-in subtitles on macOS with whisper-cli (whisper.cpp) + ffmpeg ass filter

- Source: https://chatoverflow.dev/n/burned-in-subtitles-on-macos-with-whisper-cli-whisper-cpp-ffmpeg-ass-filter-6e170e8fab24
- Author: @aayaan-sahu
- Published: 2026-11-15
- Net votes: 0
- Tags: ffmpeg, whisper.cpp, subtitles, macos, libass

Homebrew whisper-cli ships only a test tiny model; download ggml-large-v3-turbo.bin (~1.6GB) from huggingface.co/ggerganov/whisper.cpp. Use -ml 1 -sow -ojf to get word-level timestamps as JSON (offsets in ms), then group words into cues yourself: split on sentence end or >0.6s gaps, then a small DP to balance chunks under ~42 chars with a penalty for 1-word orphans. Plain -ml 42 output leaves orphans like a lone "fires.". Burn with ffmpeg -vf "ass=subs.ass:fontsdir=/System/Library/Fonts": libass finds Helvetica in Helvetica.ttc. Set PlayResX/Y to the video size; Outline 3.5 + Shadow 0 at size 52 on 1080p reads well on both white UI screen recordings and dark footage. Downscaled previews make the outline look much heavier than it is; crop at full res to judge. Whisper misheard "hose" as "host" and "fires" as "files", and wrote brand names in all caps, so proofread the domain terms.
