generate-voiceover

Generate Voiceover

Help me generate a voiceover for a Remotion video project using ElevenLabs or Qwen3-TTS.

Project Integration

Before gathering configuration, check if we're in a project context:

1. Check for active project:

   • Look for project.json in current directory or parent projects/*/
   • If found, read it to understand project state

2. Check review status: If project has phase: "review" or no reviewStatus on scenes:

   ⚠️  Scene review not complete.
   
   Generating voiceover before review risks:
   - Narration that doesn't match visuals
   - Timing mismatches
   - Wasted API credits if script needs changes
   
   Run `/scene-review` first to verify each scene in Remotion Studio.
   
   Options:
   1. Run /scene-review first (recommended)
   2. Generate voiceover anyway (not recommended)
   

   Only proceed if user explicitly chooses option 2.

3. Check for per-scene scripts (preferred): Look for public/audio/scenes/*.txt files in the project directory.

   If found:

   I see you're working on: {project.name}
   
   Found per-scene scripts in public/audio/scenes/ (recommended):
     - 01-title.txt (estimate: ~3s)
     - 02-overview.txt (estimate: ~15s)
     - 03-demo.txt (estimate: ~20s)
     - 04-summary.txt (estimate: ~12s)
   
   Total estimated: ~50 seconds of narration
   
   Options:
   1. Generate per-scene audio (recommended)
   2. Generate single voiceover file (legacy)
   

   Default to option 1 (per-scene) when scene scripts exist.

4. If no scene scripts but VOICEOVER-SCRIPT.md exists:

   I see you're working on: {project.name}
   
   Script: VOICEOVER-SCRIPT.md (ready)
   Audio status: ⬜ Not yet generated
   
   Options:
   1. Split into scene scripts first (recommended for iteration)
   2. Generate single voiceover file
   

5. After generation completes:

   • Update project.json:
     • Set audio.voiceover.status: "present"
     • If per-scene, set audio.voiceover.mode: "per_scene"
     • Transition phase if appropriate (review → audio → editing)
   • Add session entry
   • Regenerate project CLAUDE.md