Turn any script into a publish-ready voiceover — complete with numbered segments, a stitched master, YouTube chapters, SRT captions, and a beautiful review page. Optionally, replace the audio track on an existing video.
Built for creators who want studio-quality voiceovers without the studio. Powered by Voice.ai.
When to use this skill
Scenario
Why it fits
YouTube long-form
Full narration with chapter markers and captions
YouTube Shorts
Quick hooks with the shortform template
Podcasts
Consistent host voice, intro/outro templates
Course content
Professional narration for educational videos
Quick iteration
Smart caching — edit one section, only that segment re-renders
Video audio replacement
Drop AI voiceover onto screen recordings or B-roll
The one-command workflow
Have a script and a video? Turn them into a finished video with AI voiceover in one shot:
node voiceai-vo.cjs build \
--input my-script.md \
--voice oliver \
--title "My Video" \
--video ./my-recording.mp4 \
--mux
This renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:
out/my-video/muxed.mp4 — your video with the new voiceover
out/my-video/master.wav — the standalone audio
out/my-video/review.html — listen and review each segment
Use --sync pad if the audio is shorter than the video, or --sync trim to cut it to match.
Requirements
Node.js 20+ — runtime (no npm install needed — the CLI is a single bundled file)
VOICE_AI_API_KEY — set as environment variable or in a .env file in the skill root. Get a key at voice.ai/dashboard.
ffmpeg (optional) — needed for master stitching, MP3 encoding, loudness normalization, and video muxing. The pipeline still produces individual segments, the review page, chapters, and captions without it.
Configuration
The skill reads VOICE_AI_API_KEY from (in order):
Environment variable VOICE_AI_API_KEY
Environment variable VOICEAI_API_KEY (alternate)
.env file in the skill root
echo'VOICE_AI_API_KEY=your-key-here' > .env
Use --mock on any command to run the full pipeline without an API key (produces placeholder audio).
