{ "schemaVersion": "1.0", "item": { "slug": "dub-youtube-with-voiceai", "name": "Dub YouTube with Voice.ai", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/gizmoGremlin/dub-youtube-with-voiceai", "canonicalUrl": "https://clawhub.ai/gizmoGremlin/dub-youtube-with-voiceai", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/dub-youtube-with-voiceai", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dub-youtube-with-voiceai", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "dub-youtube-with-voiceai.yaml", "examples/shorts_script.txt", "examples/youtube_script.md", "references/TROUBLESHOOTING.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/dub-youtube-with-voiceai" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/dub-youtube-with-voiceai", "agentPageUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent", "manifestUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent.json", "briefUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Dub YouTube with Voice.ai", "body": "This skill follows the Agent Skills specification.\n\nTurn 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.\n\nBuilt for YouTube creators who want studio-quality narration without the studio. Powered by Voice.ai." }, { "title": "When to use this skill", "body": "ScenarioWhy it fitsYouTube long-formFull narration with chapter markers and captionsYouTube ShortsQuick hooks with punchy deliveryCourse contentProfessional narration for educational videosScreen recordingsDub a screencast with clean AI voiceoverQuick iterationSmart caching — edit one section, only that segment re-rendersBatch productionSame voice, consistent quality across every video" }, { "title": "The one-command workflow", "body": "Have a script and a video? Dub it in one shot:\n\nnode voiceai-vo.cjs build \\\n --input my-script.md \\\n --voice oliver \\\n --title \"My YouTube Video\" \\\n --video ./my-recording.mp4 \\\n --mux \\\n --template youtube\n\nThis renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:\n\nout/my-youtube-video/muxed.mp4 — your video dubbed with the AI voiceover\nout/my-youtube-video/master.wav — the standalone audio\nout/my-youtube-video/review.html — listen and review each segment\nout/my-youtube-video/chapters.txt — paste directly into your YouTube description\nout/my-youtube-video/captions.srt — upload to YouTube as subtitles\nout/my-youtube-video/description.txt — ready-made YouTube description with chapters\n\nUse --sync pad if the audio is shorter than the video, or --sync trim to cut it to match." }, { "title": "Requirements", "body": "Node.js 20+ — runtime (no npm install needed — the CLI is a single bundled file)\nVOICE_AI_API_KEY — set as environment variable or in a .env file in the skill root. Get a key at voice.ai/dashboard.\nffmpeg (optional) — needed for master stitching, MP3 encoding, loudness normalization, and video dubbing. The pipeline still produces individual segments, the review page, chapters, and captions without it." }, { "title": "Configuration", "body": "Set VOICE_AI_API_KEY as an environment variable before running:\n\nexport VOICE_AI_API_KEY=your-key-here\n\nThe skill does not read .env files or access any files for credentials — only the environment variable.\n\nUse --mock on any command to run the full pipeline without an API key (produces placeholder audio)." }, { "title": "build — Generate a YouTube voiceover from a script", "body": "node voiceai-vo.cjs build \\\n --input \\\n --voice \\\n --title \"My YouTube Video\" \\\n [--template youtube] \\\n [--video input.mp4 --mux --sync shortest] \\\n [--force] [--mock]\n\nWhat it does:\n\nReads the script and splits it into segments (by ## headings for .md, or by sentence boundaries for .txt)\nOptionally prepends/appends YouTube intro/outro segments\nRenders each segment via Voice.ai TTS\nStitches a master audio file (if ffmpeg is available)\nGenerates YouTube chapters, SRT captions, a review page, and a ready-made description\nOptionally dubs your video with the voiceover\n\nFull options:\n\nOptionDescription-i, --input Script file (.txt or .md) — required-v, --voice Voice alias or UUID — required-t, --title Video title (defaults to filename)--template youtubeAuto-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--muxEnable video dubbing (requires --video)--sync <policy>shortest, pad, or trim (default: shortest)--forceRe-render all segments (ignore cache)--mockMock mode — no API calls, placeholder audio-o, --out <dir>Custom output directory" }, { "title": "replace-audio — Dub an existing video", "body": "node voiceai-vo.cjs replace-audio \\\n --video ./my-video.mp4 \\\n --audio ./out/my-video/master.wav \\\n [--out ./out/my-video/dubbed.mp4] \\\n [--sync shortest|pad|trim]\n\nRequires ffmpeg. If not installed, generates helper shell/PowerShell scripts instead.\n\nSync policyBehaviorshortest (default)Output ends when the shorter track endspadPad audio with silence to match video durationtrimTrim audio to match video duration\n\nVideo stream is copied without re-encoding (-c:v copy). Audio is encoded as AAC for YouTube compatibility.\n\nPrivacy: Video processing is entirely local. Only script text is sent to Voice.ai for TTS. Your video files never leave your machine." }, { "title": "voices — List available voices", "body": "node voiceai-vo.cjs voices [--limit 20] [--query \"deep\"] [--mock]" }, { "title": "Available voices", "body": "Use short aliases or full UUIDs with --voice:\n\nAliasVoiceGenderBest for YouTubeellieEllieFVlogs, lifestyle, social contentoliverOliverMTutorials, narration, explainerslilithLilithFASMR, calm walkthroughssmoothSmooth Calm VoiceMDocumentaries, long-form essayscorpseCorpse HusbandMGaming, entertainmentskadiSkadiFAnime, character contentzhongliZhongliMGaming, dramatic introsfloraFloraFKids content, upbeat videoschiefMaster ChiefMGaming, action trailers\n\nThe voices command also returns any additional voices available on the API. Voice list is cached for 10 minutes." }, { "title": "Build outputs", "body": "After a build, the output directory contains everything you need to publish on YouTube:\n\nout/<title-slug>/\n segments/ # Numbered WAV files (001-intro.wav, 002-section.wav, …)\n master.wav # Stitched voiceover (requires ffmpeg)\n master.mp3 # MP3 for upload (requires ffmpeg)\n muxed.mp4 # Dubbed video (if --video --mux used)\n chapters.txt # Paste into YouTube description\n captions.srt # Upload as YouTube subtitles\n description.txt # Ready-made YouTube description with chapters\n review.html # Interactive review page with audio players\n manifest.json # Build metadata: voice, template, segment list\n timeline.json # Segment durations and start times" }, { "title": "YouTube workflow", "body": "Run the build command\nUpload muxed.mp4 (or your original video + master.mp3 as audio)\nPaste chapters.txt content into your YouTube description\nUpload captions.srt as subtitles in YouTube Studio\nDone — professional narration, chapters, and captions in minutes" }, { "title": "YouTube template", "body": "Use --template youtube to auto-inject a branded intro and outro:\n\nSegmentSource fileIntro (prepended)templates/youtube_intro.txtOutro (appended)templates/youtube_outro.txt\n\nEdit the files in templates/ to customize your channel's branding." }, { "title": "Caching", "body": "Segments are cached by a hash of: text content + voice ID + language.\n\nUnchanged segments are skipped on rebuild — fast iteration\nModified segments are re-rendered automatically\nUse --force to re-render everything\nCache manifest is stored in segments/.cache.json" }, { "title": "Multilingual dubbing", "body": "Voice.ai supports 11 languages — dub your YouTube videos for global audiences:\n\nen, es, fr, de, it, pt, pl, ru, nl, sv, ca\n\nnode voiceai-vo.cjs build \\\n --input script-spanish.md \\\n --voice ellie \\\n --title \"Mi Video\" \\\n --language es \\\n --video ./my-video.mp4 \\\n --mux\n\nThe pipeline auto-selects the multilingual TTS model for non-English languages." }, { "title": "Troubleshooting", "body": "IssueSolutionffmpeg missingPipeline 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 scriptsCaching makes rebuilds fast. Text over 490 chars per segment is automatically split across API calls.Windows pathsWrap paths with spaces in quotes: --input \"C:\\My Scripts\\script.md\"\n\nSee references/TROUBLESHOOTING.md for more." }, { "title": "References", "body": "Agent Skills Specification\nVoice.ai\nreferences/VOICEAI_API.md — API endpoints, audio formats, models\nreferences/TROUBLESHOOTING.md — Common issues and fixes" } ], "body": "Dub YouTube with Voice.ai\n\nThis skill follows the Agent Skills specification.\n\nTurn 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.\n\nBuilt for YouTube creators who want studio-quality narration without the studio. Powered by Voice.ai.\n\nWhen to use this skill\nScenario\tWhy it fits\nYouTube long-form\tFull narration with chapter markers and captions\nYouTube Shorts\tQuick hooks with punchy delivery\nCourse content\tProfessional narration for educational videos\nScreen recordings\tDub a screencast with clean AI voiceover\nQuick iteration\tSmart caching — edit one section, only that segment re-renders\nBatch production\tSame voice, consistent quality across every video\nThe one-command workflow\n\nHave a script and a video? Dub it in one shot:\n\nnode voiceai-vo.cjs build \\\n --input my-script.md \\\n --voice oliver \\\n --title \"My YouTube Video\" \\\n --video ./my-recording.mp4 \\\n --mux \\\n --template youtube\n\n\nThis renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:\n\nout/my-youtube-video/muxed.mp4 — your video dubbed with the AI voiceover\nout/my-youtube-video/master.wav — the standalone audio\nout/my-youtube-video/review.html — listen and review each segment\nout/my-youtube-video/chapters.txt — paste directly into your YouTube description\nout/my-youtube-video/captions.srt — upload to YouTube as subtitles\nout/my-youtube-video/description.txt — ready-made YouTube description with chapters\n\nUse --sync pad if the audio is shorter than the video, or --sync trim to cut it to match.\n\nRequirements\nNode.js 20+ — runtime (no npm install needed — the CLI is a single bundled file)\nVOICE_AI_API_KEY — set as environment variable or in a .env file in the skill root. Get a key at voice.ai/dashboard.\nffmpeg (optional) — needed for master stitching, MP3 encoding, loudness normalization, and video dubbing. The pipeline still produces individual segments, the review page, chapters, and captions without it.\nConfiguration\n\nSet VOICE_AI_API_KEY as an environment variable before running:\n\nexport VOICE_AI_API_KEY=your-key-here\n\n\nThe skill does not read .env files or access any files for credentials — only the environment variable.\n\nUse --mock on any command to run the full pipeline without an API key (produces placeholder audio).\n\nCommands\nbuild — Generate a YouTube voiceover from a script\nnode voiceai-vo.cjs build \\\n --input <script.md or script.txt> \\\n --voice <voice-alias-or-uuid> \\\n --title \"My YouTube Video\" \\\n [--template youtube] \\\n [--video input.mp4 --mux --sync shortest] \\\n [--force] [--mock]\n\n\nWhat it does:\n\nReads the script and splits it into segments (by ## headings for .md, or by sentence boundaries for .txt)\nOptionally prepends/appends YouTube intro/outro segments\nRenders each segment via Voice.ai TTS\nStitches a master audio file (if ffmpeg is available)\nGenerates YouTube chapters, SRT captions, a review page, and a ready-made description\nOptionally dubs your video with the voiceover\n\nFull options:\n\nOption\tDescription\n-i, --input <path>\tScript file (.txt or .md) — required\n-v, --voice <id>\tVoice alias or UUID — required\n-t, --title <title>\tVideo title (defaults to filename)\n--template youtube\tAuto-inject YouTube intro/outro\n--mode <mode>\theadings or auto (default: headings for .md)\n--max-chars <n>\tMax characters per auto-chunk (default: 1500)\n--language <code>\tLanguage code (default: en)\n--video <path>\tInput video to dub\n--mux\tEnable video dubbing (requires --video)\n--sync <policy>\tshortest, pad, or trim (default: shortest)\n--force\tRe-render all segments (ignore cache)\n--mock\tMock mode — no API calls, placeholder audio\n-o, --out <dir>\tCustom output directory\nreplace-audio — Dub an existing video\nnode voiceai-vo.cjs replace-audio \\\n --video ./my-video.mp4 \\\n --audio ./out/my-video/master.wav \\\n [--out ./out/my-video/dubbed.mp4] \\\n [--sync shortest|pad|trim]\n\n\nRequires ffmpeg. If not installed, generates helper shell/PowerShell scripts instead.\n\nSync policy\tBehavior\nshortest (default)\tOutput ends when the shorter track ends\npad\tPad audio with silence to match video duration\ntrim\tTrim audio to match video duration\n\nVideo stream is copied without re-encoding (-c:v copy). Audio is encoded as AAC for YouTube compatibility.\n\nPrivacy: Video processing is entirely local. Only script text is sent to Voice.ai for TTS. Your video files never leave your machine.\n\nvoices — List available voices\nnode voiceai-vo.cjs voices [--limit 20] [--query \"deep\"] [--mock]\n\nAvailable voices\n\nUse short aliases or full UUIDs with --voice:\n\nAlias\tVoice\tGender\tBest for YouTube\nellie\tEllie\tF\tVlogs, lifestyle, social content\noliver\tOliver\tM\tTutorials, narration, explainers\nlilith\tLilith\tF\tASMR, calm walkthroughs\nsmooth\tSmooth Calm Voice\tM\tDocumentaries, long-form essays\ncorpse\tCorpse Husband\tM\tGaming, entertainment\nskadi\tSkadi\tF\tAnime, character content\nzhongli\tZhongli\tM\tGaming, dramatic intros\nflora\tFlora\tF\tKids content, upbeat videos\nchief\tMaster Chief\tM\tGaming, action trailers\n\nThe voices command also returns any additional voices available on the API. Voice list is cached for 10 minutes.\n\nBuild outputs\n\nAfter a build, the output directory contains everything you need to publish on YouTube:\n\nout/<title-slug>/\n segments/ # Numbered WAV files (001-intro.wav, 002-section.wav, …)\n master.wav # Stitched voiceover (requires ffmpeg)\n master.mp3 # MP3 for upload (requires ffmpeg)\n muxed.mp4 # Dubbed video (if --video --mux used)\n chapters.txt # Paste into YouTube description\n captions.srt # Upload as YouTube subtitles\n description.txt # Ready-made YouTube description with chapters\n review.html # Interactive review page with audio players\n manifest.json # Build metadata: voice, template, segment list\n timeline.json # Segment durations and start times\n\nYouTube workflow\nRun the build command\nUpload muxed.mp4 (or your original video + master.mp3 as audio)\nPaste chapters.txt content into your YouTube description\nUpload captions.srt as subtitles in YouTube Studio\nDone — professional narration, chapters, and captions in minutes\nYouTube template\n\nUse --template youtube to auto-inject a branded intro and outro:\n\nSegment\tSource file\nIntro (prepended)\ttemplates/youtube_intro.txt\nOutro (appended)\ttemplates/youtube_outro.txt\n\nEdit the files in templates/ to customize your channel's branding.\n\nCaching\n\nSegments are cached by a hash of: text content + voice ID + language.\n\nUnchanged segments are skipped on rebuild — fast iteration\nModified segments are re-rendered automatically\nUse --force to re-render everything\nCache manifest is stored in segments/.cache.json\nMultilingual dubbing\n\nVoice.ai supports 11 languages — dub your YouTube videos for global audiences:\n\nen, es, fr, de, it, pt, pl, ru, nl, sv, ca\n\nnode voiceai-vo.cjs build \\\n --input script-spanish.md \\\n --voice ellie \\\n --title \"Mi Video\" \\\n --language es \\\n --video ./my-video.mp4 \\\n --mux\n\n\nThe pipeline auto-selects the multilingual TTS model for non-English languages.\n\nTroubleshooting\nIssue\tSolution\nffmpeg missing\tPipeline still works — you get segments, review page, chapters, captions. Install ffmpeg for stitching and video dubbing.\nRate limits (429)\tSegments render sequentially, which stays under most limits. Wait and retry.\nInsufficient credits (402)\tTop up at voice.ai/dashboard. Cached segments won't re-use credits on retry.\nLong scripts\tCaching makes rebuilds fast. Text over 490 chars per segment is automatically split across API calls.\nWindows paths\tWrap paths with spaces in quotes: --input \"C:\\My Scripts\\script.md\"\n\nSee references/TROUBLESHOOTING.md for more.\n\nReferences\nAgent Skills Specification\nVoice.ai\nreferences/VOICEAI_API.md — API endpoints, audio formats, models\nreferences/TROUBLESHOOTING.md — Common issues and fixes" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/gizmoGremlin/dub-youtube-with-voiceai", "publisherUrl": "https://clawhub.ai/gizmoGremlin/dub-youtube-with-voiceai", "owner": "gizmoGremlin", "version": "0.1.6", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai", "downloadUrl": "https://openagent3.xyz/downloads/dub-youtube-with-voiceai", "agentUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent", "manifestUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent.json", "briefUrl": "https://openagent3.xyz/skills/dub-youtube-with-voiceai/agent.md" } }