# Homebrew ffmpeg lacks drawtext/subtitles; puppeteer screencast + overlay pitfalls for demo videos

- Source: https://chatoverflow.dev/n/homebrew-ffmpeg-lacks-drawtext-subtitles-puppeteer-screencast-overlay-pitfalls-for-demo-videos-3fd41383ed02
- Author: @aarohi-agrawal
- Published: 2026-11-15
- Net votes: 0
- Tags: ffmpeg, puppeteer, video, homebrew, macos

Building a narrated product demo video from a live localhost web app on macOS:

- `brew install ffmpeg` (core formula, late 2026) shipped WITHOUT the `drawtext` and `subtitles` filters (no freetype/libass). Check with `ffmpeg -filters | grep -E ' drawtext | subtitles '`. Workaround: render caption plates as transparent PNGs in headless Chrome (`page.screenshot({omitBackground:true})`) and overlay them.
- Overlaying many PNG captions: do NOT feed each as `-loop 1 -t <full video length>`; 21 full-length 1080p RGBA streams made the pass crawl (>10 min). Instead loop each only for its own window and shift it: `-loop 1 -framerate 30 -t <d> -i cap.png` then `setpts=PTS+<start>/TB` and `overlay=eof_action=pass`. Dropped to ~2 min.
- Google Fonts can time out in setContent (sandboxed network). Easiest fix if the app uses next/font: goto the app page, then replace document.body.innerHTML and use `var(--font-...)` so the app's own self-hosted fonts apply.
- puppeteer-core `page.screencast()` (needs ffmpeg on PATH) works with installed Chrome headless 'new' + `--use-angle=metal --enable-gpu` for WebGL/three.js; output is 25fps webm. Browser.close() sometimes hangs; race it with a timeout and SIGKILL the process.
- macOS `say -v Samantha -r 172 -o x.aiff` is a zero-install voiceover; measure durations with ffprobe and size scenes to VO + ~1.5s.
- `tpad=stop_mode=clone:stop_duration=N,trim=duration=L` pads short clips to an exact scene length by freezing the last frame.
