dub-youtube-with-voiceai

Dub YouTube videos with Voice.ai TTS. Turn scripts into publish-ready voiceovers with chapters, captions, and audio replacement for YouTube long-form and Shorts.

Aller à l'installation

Dépôt: javimosch/open-claw-skills
Dernière activité de la source: 6 juin 2026 à 19:20
Langue détectée de SKILL.md: anglais
Étoiles: 0
Forks: 1

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Retour à la recherche Retour à l’installation

name	dub-youtube-with-voiceai
description	Dub YouTube videos with Voice.ai TTS. Turn scripts into publish-ready voiceovers with chapters, captions, and audio replacement for YouTube long-form and Shorts.
version	0.1.2
env	["VOICE_AI_API_KEY"]
required_env	["VOICE_AI_API_KEY"]
credentials	["VOICE_AI_API_KEY"]
setup	none — single file, runs directly with Node.js
runtime	node>=20
optional_deps	ffmpeg

Dub YouTube with Voice.ai

This skill follows the Agent Skills specification.

Turn any script into a YouTube-ready voiceover — complete with numbered segments, a stitched master, chapter timestamps, SRT captions, and a review page. Drop the voiceover onto an existing video to dub it in one command.

Built for YouTube creators who want studio-quality narration 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 punchy delivery
Course content	Professional narration for educational videos
Screen recordings	Dub a screencast with clean AI voiceover
Quick iteration	Smart caching — edit one section, only that segment re-renders
Batch production	Same voice, consistent quality across every video

The one-command workflow

Have a script and a video? Dub it in one shot:

node voiceai-vo.cjs build \
  --input my-script.md \
  --voice oliver \
  --title "My YouTube Video" \
  --video ./my-recording.mp4 \
  --mux \
  --template youtube

This renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:

out/my-youtube-video/muxed.mp4 — your video dubbed with the AI voiceover
out/my-youtube-video/master.wav — the standalone audio
out/my-youtube-video/review.html — listen and review each segment
out/my-youtube-video/chapters.txt — paste directly into your YouTube description
out/my-youtube-video/captions.srt — upload to YouTube as subtitles
out/my-youtube-video/description.txt — ready-made YouTube description with chapters

Use --sync pad if the audio is shorter than the video, or --sync trim to cut it to match.

export VOICE_AI_API_KEY=your-key-here

node voiceai-vo.cjs build \
  --input <script.md or script.txt> \
  --voice <voice-alias-or-uuid> \
  --title "My YouTube Video" \
  [--template youtube] \
  [--video input.mp4 --mux --sync shortest] \
  [--force] [--mock]

Option	Description
`-i, --input <path>`	Script file (.txt or .md) — required
`-v, --voice <id>`	Voice alias or UUID — required
`-t, --title <title>`	Video title (defaults to filename)
`--template youtube`	Auto-inject YouTube intro/outro
`--mode <mode>`	`headings` or `auto` (default: headings for .md)
`--max-chars <n>`	Max characters per auto-chunk (default: 1500)
`--language <code>`	Language code (default: en)
`--video <path>`	Input video to dub
`--mux`	Enable video dubbing (requires --video)
`--sync <policy>`	`shortest`, `pad`, or `trim` (default: shortest)
`--force`	Re-render all segments (ignore cache)
`--mock`	Mock mode — no API calls, placeholder audio
`-o, --out <dir>`	Custom output directory

node voiceai-vo.cjs replace-audio \
  --video ./my-video.mp4 \
  --audio ./out/my-video/master.wav \
  [--out ./out/my-video/dubbed.mp4] \
  [--sync shortest|pad|trim]

node voiceai-vo.cjs voices [--limit 20] [--query "deep"] [--mock]

Alias	Voice	Gender	Best for YouTube
`ellie`	Ellie	F	Vlogs, lifestyle, social content
`oliver`	Oliver	M	Tutorials, narration, explainers
`lilith`	Lilith	F	ASMR, calm walkthroughs
`smooth`	Smooth Calm Voice	M	Documentaries, long-form essays
`corpse`	Corpse Husband	M	Gaming, entertainment
`skadi`	Skadi	F	Anime, character content
`zhongli`	Zhongli	M	Gaming, dramatic intros
`flora`	Flora	F	Kids content, upbeat videos
`chief`	Master Chief	M	Gaming, action trailers

out/<title-slug>/
  segments/           # Numbered WAV files (001-intro.wav, 002-section.wav, …)
  master.wav          # Stitched voiceover (requires ffmpeg)
  master.mp3          # MP3 for upload (requires ffmpeg)
  muxed.mp4           # Dubbed video (if --video --mux used)
  chapters.txt        # Paste into YouTube description
  captions.srt        # Upload as YouTube subtitles
  description.txt     # Ready-made YouTube description with chapters
  review.html         # Interactive review page with audio players
  manifest.json       # Build metadata: voice, template, segment list
  timeline.json       # Segment durations and start times

node voiceai-vo.cjs build \
  --input script-spanish.md \
  --voice ellie \
  --title "Mi Video" \
  --language es \
  --video ./my-video.mp4 \
  --mux

Issue	Solution
ffmpeg missing	Pipeline still works — you get segments, review page, chapters, captions. Install ffmpeg for stitching and video dubbing.
Rate limits (429)	Segments render sequentially, which stays under most limits. Wait and retry.
Insufficient credits (402)	Top up at voice.ai/dashboard. Cached segments won't re-use credits on retry.
Long scripts	Caching makes rebuilds fast. Text over 490 chars per segment is automatically split across API calls.
Windows paths	Wrap paths with spaces in quotes: `--input "C:\My Scripts\script.md"`