remotion-excalidraw-tts

name	remotion-excalidraw-tts
description	Generate a narrated Remotion video from an Excalidraw (.excalidraw) diagram using text-to-speech (macOS say) and render to MP4. Use when creating explainer videos with pan/zoom + focus highlights over Excalidraw diagrams, with automated voiceover generation and Remotion CLI rendering.

Remotion + Excalidraw + TTS (Local)

Use this skill to turn an Excalidraw diagram + a voiceover script into a rendered MP4 using:

• Remotion (render)
• Excalidraw (render the .excalidraw JSON directly)
• TTS via macOS say (offline)

Quick start (one command)

Run:

python3 skills/remotion-excalidraw-tts/scripts/make_video.py \
  --diagram /absolute/path/to/diagram.excalidraw \
  --voiceover-text /absolute/path/to/voiceover.txt \
  --out /absolute/path/to/out.mp4

Optional: drive camera/focus/subtitles via storyboard JSON:

python3 skills/remotion-excalidraw-tts/scripts/make_video.py \
  --diagram /absolute/path/to/diagram.excalidraw \
  --voiceover-text /absolute/path/to/voiceover.txt \
  --storyboard-json /absolute/path/to/storyboard.json \
  --out /absolute/path/to/out.mp4

What it does:

1. copies the Remotion template project from assets/template/remotion-project/ into a temp workdir
2. writes public/diagram.excalidraw
3. generates public/voiceover.mp3 via say + ffmpeg
4. sets composition duration to match the voiceover length
5. renders MP4 with npx remotion render

Inputs

• --diagram: .excalidraw JSON file (from Excalidraw export)