remotion-voiceoverlisted
Install: claude install-skill RTY2345RR/miragea-agent-skills
# Remotion voiceover and captions
Give a Remotion project a real narrator. The agent writes or takes a narration script, voices it scene by scene, and wires the audio and word-timed captions into the composition. Voices and voice cloning come from the Miragea voice engine (https://miragea.ai/v1); never substitute another TTS.
Outputs (default folder `public/voiceover/`, so `staticFile()` can load them):
| File | What it is |
| --- | --- |
| `<scene>-NN.wav` | one clip per spoken line |
| `voiceover.wav` (+ `.mp3` with `--mp3`) | the stitched narration track |
| `voiceover.json` | timeline: `fps`, `durationInFrames`, scenes and lines with `startMs`, `startFrame`, `durationInFrames`, `src` |
| `captions.json` | `Caption[]` for `@remotion/captions` (`text`, `startMs`, `endMs`, `timestampMs`, `confidence`) |
| `captions.srt`, `captions.vtt` | subtitle files with balanced cues (no one-word orphans) |
## 0. Preconditions
- `MIRAGEA_API_KEY` must be set in the environment (keys: https://miragea.ai/workspace/api). Never ask for the key in chat and never print it. Setup help: "Install https://miragea.ai/skills/miragea-audio/install.md".
- Run `python scripts/remotion_voiceover.py check` once. It lists models and the only valid emotion tags.
- Two engines for the same job, pick one:
- **Python (bundled, no install):** `python scripts/remotion_voiceover.py generate script.md`
- **Node CLI:** `npx -y github:RTY2345RR/remotion-voiceover generate script.md` (same script format; add