voiceai-creator-voiceover-pipeline

Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing.

Aller à l'installation

Dépôt: johnalbertini14-glitch/openclaw-skills
Dernière activité de la source: 11 février 2026 à 11:32
Langue détectée de SKILL.md: anglais
Étoiles: 1
Forks: 0

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	voiceai-creator-voiceover-pipeline
description	Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing.
version	0.2.1
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

Voice.ai Creator Voiceover Pipeline

This skill follows the Agent Skills specification.

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
out/my-video/chapters.txt — YouTube-ready chapter timestamps
out/my-video/captions.srt — SRT captions

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)

echo 'VOICE_AI_API_KEY=your-key-here' > .env

node voiceai-vo.cjs build \
  --input <script.md or script.txt> \
  --voice <voice-alias-or-uuid> \
  --title "My Project" \
  [--template youtube|podcast|shortform] \
  [--language en] \
  [--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>`	Project title (defaults to filename)
`--template <name>`	`youtube`, `podcast`, or `shortform`
`--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 for muxing
`--mux`	Enable video muxing (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 ./input.mp4 \
  --audio ./out/my-project/master.wav \
  [--out ./out/my-project/muxed.mp4] \
  [--sync shortest|pad|trim]

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

Alias	Voice	Gender	Style
`ellie`	Ellie	F	Youthful, vibrant vlogger
`oliver`	Oliver	M	Friendly British
`lilith`	Lilith	F	Soft, feminine
`smooth`	Smooth Calm Voice	M	Deep, smooth narrator
`corpse`	Corpse Husband	M	Deep, distinctive
`skadi`	Skadi	F	Anime character
`zhongli`	Zhongli	M	Deep, authoritative
`flora`	Flora	F	Cheerful, high pitch
`chief`	Master Chief	M	Heroic, commanding

out/<title-slug>/
  segments/           # Numbered WAV files (001-intro.wav, 002-section.wav, …)
  master.wav          # Stitched audio (requires ffmpeg)
  master.mp3          # MP3 encode (requires ffmpeg)
  manifest.json       # Build metadata: voice, template, segment list, hashes
  timeline.json       # Segment durations and start times
  review.html         # Interactive review page with audio players
  chapters.txt        # YouTube-friendly chapter timestamps
  captions.srt        # SRT captions using segment boundaries
  description.txt     # YouTube description with chapters + Voice.ai credit

Issue	Solution
ffmpeg missing	Pipeline still works — you get segments, review page, chapters, captions. Install ffmpeg for master stitching and video muxing.
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"`