---
name: movie-maker
description: Use when the user asks to "record a video", "record a demo", "create a walkthrough", "make a movie", "record the project", "narrate a walkthrough", "record my screen", "show my recordings", "play a video", "list my videos", "execute a script", "run a walkthrough script", "create a recording script", or wants to capture narrated screen recordings with silence detection and smart playback.
---

# Movie Maker

Record narrated walkthroughs of your Gallia project. Captures browser tab video + microphone audio, detects silence, and provides smart playback that skips dead air. Videos are organized in a Library with thumbnails, duration, and talking/silence breakdowns.

**Input**: User clicks Record in toolbar or Movie Maker UI, or Claude executes a script
**Output**: `.webm` video files stored in project content, viewable in the Library

## Architecture

Recording runs in the **parent frame** (index.html toolbar) to avoid iframe `getDisplayMedia` restrictions. If that fails, falls back to a popup tab (`record-popup.html`). Communication between components uses `BroadcastChannel` (popup mode) or `postMessage` (parent mode).

## MCP Tools

### gv_recording_status
Check if Movie Maker is currently recording.

### gv_execute_script
Execute a scripted walkthrough that controls the viewer with timed steps.

#### Script Step Actions

| Action | Description | Params |
|--------|-------------|--------|
| `show_3d` | Load a GLB 3D model | `glb_path` (required) |
| `set_view` | Camera preset | `view`: front, back, left, right, top, bottom, isometric |
| `set_camera` | Custom camera angle | `alpha`, `beta`, `radius` |
| `start_tour` | Begin cinematic camera rotation | (none) |
| `stop_tour` | Stop camera rotation | (none) |
| `display` | Show HTML content | `html`, `title` |
| `display_file` | Show a file | `file_path`, `title` |
| `caption` | Overlay text on screen | `text` |
| `wait` | Pause between steps | (none) |
| `show_files` | Show file explorer | `path` (optional) |

## Recording Features

### Silence Detection
During recording, an AnalyserNode monitors microphone audio levels. Stretches below threshold lasting 2+ seconds are marked as silence regions.

### Smart Playback
Player speeds through silence regions at 16x, returning to 1x when talking resumes.

### Timeline Markers
Yellow markers for each silence region, Prev/Next buttons, click-to-seek.

### Toolbar Record Button
Record from any view via toolbar button. Alt+R shortcut. Timer and red dot during recording.

### TabShot Conflict Detection
Recording blocked when Screen Capture is active.