🎙️ Audio Narratives
slides-tape v2.1.0 introduces natively integrated audio narrative recording. You can now record your voiceover directly in the browser while previewing your slides, and the engine will automatically mux that audio into your final video export.
1. Recording Live
When you run slides-tape serve, the viewer now includes a Record button.
- Start Recording: Click the microphone icon.
slides-tapeuses the browser’sMediaRecorderAPI to capture your microphone stream. - Present: Advance your slides naturally. Every time you change a slide,
slides-taperecords a timestamp log. - Stop Recording: Click the stop button. The engine will save a
.wavfile and a.narrative.jsonlog mapping your voice to specific slide transitions.
2. Synchronized Export
The true power of audio narratives is Sychronized Export. You no longer need to manually set @wait durations or guess slide timings.
When you run the export or run command, slides-tape detects the narrative logs and:
- Matches Timings: The video transitions happen exactly when you transitioned during the live recording.
- Auto-Muxing: The engine uses FFmpeg to mux the recorded audio track into the high-performance terminal/browser video stream.
CLI Flags for Audio
| Flag | Description |
|---|---|
--narrative-only | Re-renders the video using existing narrative logs, overwriting the audio track. |
--no-narrative | Forces a silent export, even if narrative logs are present. |
3. How it Works
- Phase 1: Capture audio and transition events in the browser.
- Phase 2: The deterministic renderer builds the video frames.
- Phase 3: FFmpeg combines the frame sequence and the
.wavfile into a singlemp4/webmfile.
[!TIP] Use a high-quality microphone and a quiet environment. Since the rendering is deterministic, your audio will perfectly align with the terminal typing and browser animations every single time.