remotion-narrationlisted
Install: claude install-skill yyert123/miragea-skills
# Remotion narration
Writes everything a Remotion composition needs to be driven by its voiceover: audio per scene, exact
durations, start frames and captions. Scene lengths come from the real audio, so nothing drifts.
## When to use
- The user has a script (Markdown, text or JSON) and a Remotion project and wants narration.
- Scenes should last exactly as long as their voiceover; captions should follow the voice word by word.
## Steps
1. Make sure `MIRAGEA_API_KEY` is set (never print it). Pick the voice:
- `--voice VOICE_ID` - a voice saved in the user's Miragea account, or
- `--ref-url https://...` - a public clip of the voice to clone (with the user's consent), plus
`--ref-text "exact words in the clip"` for the cheaper 1x rate.
2. Write the script. Each `## Heading` (or blank-line paragraph) becomes one scene:
```markdown
## intro
Meet Retake, the fastest way to fix a voiceover mistake.
## demo
Type the right word. Retake re-voices the sentence and splices it in.
```
3. Generate into the Remotion `public/` folder:
```bash
python3 scripts/narrate.py script.md --voice VOICE_ID --out public/narration --fps 30
```
4. Use `public/narration/narration.json` in the composition (see `examples/Narrated.tsx`):
`totalFrames` for `durationInFrames`, each scene's `startFrame` / `durationInFrames` for a
`<Sequence>`, `staticFile('narration/' + scene.file)` for `<Audio>`, and `scene.captions`
(Remotion `Caption[]`: `text`, `startMs