alexansart/demo-studio

narrate

Generates a narration voiceover .mp3 for a demo video script using the ElevenLabs API — configurable voice/model/stability, deterministic output filename.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/alexansart/demo-studio --skill narrate

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Narrate — generate a voiceover with ElevenLabs

Turns a plain-text script into an .mp3 narration track. This is stage 1 of the full pipeline (produce-video); use it standalone if you already have a silent video and just need the voice.

Requires ELEVENLABS_API_KEY (see .env.example at the project root — get a key at https://elevenlabs.io). No key, no narration — produce-video and film-demo both work fine without this skill (silent video only).

Quick start

bash
pip install -r scripts/requirements.txt   # once

python scripts/generate_narration.py \
  --out demos/<slug>/narration.mp3 \
  --text "Here's how it works. Type your task, hit add, and watch it appear instantly."

Or --text-file script.txt for longer scripts. The script writes exactly one .mp3 at --out — no auto-naming, so it composes cleanly into a pipeline.

Defaults (override via flags or demo.config.json → narration)

SettingDefaultFlag
Voice"Rachel" (search by name in your ElevenLabs voice library)--voice-name
Voice ID (skips the name search)—--voice-id
Modeleleven_v3--model
Stability1.0 (Robust — v3 scale: 0.0 Creative, 0.5 Natural, 1.0 Robust)--stability
Output formatmp3_44100_128--format

Pick a voice from your own ElevenLabs account (or a shared voice you've added to your library) and set it once in demo.config.json → narration.voiceName so every video in the project uses the same voice. --voice-name does a voices.search() by exact name — if you get "voice not found", the voice either isn't in your account yet (add it from the ElevenLabs Voice Library first) or the name doesn't match exactly; pass --voice-id instead to skip the search entirely.

Script-writing rules (these make sync easier later)

  • Plain sentences, one idea each. sync-narration aligns and cuts at

sentence boundaries — a 40-word sentence covering three on-screen actions cannot be split apart later.

  • Write to match the pacing you'll film, not the other way around. ~150

words/minute is natural TTS speed — a 60-90s video needs roughly 150-220 words of narration.

  • No stage directions or brackets ("[pause]", "(click here)") — the model

reads them aloud. Convey pacing with actual punctuation and sentence breaks.

  • Say what's on screen in the order it happens. sync-narration maps

sentence order to beat order 1:1 — reordering later means re-aligning.

Gate before moving on

bash
ffprobe -v error -show_entries format=duration -of csv=p=0 demos/<slug>/narration.mp3

Confirm the duration is plausible for the word count (~150 wpm). Regenerating costs API credits — only do it when the script text actually changes; reuse the existing .mp3 otherwise.

Deliverable

Report the output path, duration, voice/model used, and word count. If ELEVENLABS_API_KEY is missing, say so explicitly and stop — do not silently fall back to a different provider or skip narration without telling the user.

같은 저장소의 Skills

더 많은 Skills

모든 Skills
alexansart
커뮤니티

demo-setup

One-time setup that analyzes the current project and configures it to use the film-demo / narrate / sync-narration / produce-video skills — detects the dev server and framework, asks only when necessary, generates demo.config.json and .env entries, vendors the recording engine and project helpers, and scaffolds a first demo from reference patterns. Use when the user asks to set up, configure, or install demo-studio / video-recording skills for this project, or before running produce-video for th

1시간 설치 수
1
GitHub Stars
5
업데이트
7월 26일
alexansart
커뮤니티

film-demo

Records a polished, silent screen-capture demo video of any web app from a plain-English beat script — Playwright capture with a real cursor, human-speed typing, explicit zone-based zooms (focus/wide) with guaranteed containment, deterministic guardrails (cursor offscreen, zoom too long, inactivity), annotated frame inspection, post-record speed-ups, styled frame, and a verify/iterate loop. Use when the user asks to record, film, or generate a demo/tutorial/product video of a web app.

1시간 설치 수
1
GitHub Stars
5
업데이트
7월 26일
alexansart
커뮤니티

produce-video

End-to-end production of a narrated, captioned demo video for any web app — chains narration generation (narrate), silent Playwright recording (film-demo, smart zooms + guardrails), and narration sync with burned captions (sync-narration) into one final .mp4. Use when the user asks to produce, make, or film a demo/product/tutorial video end to end, "with voice and subtitles", or "from A to Z".

1시간 설치 수
1
GitHub Stars
5
업데이트
7월 26일
alexansart
커뮤니티

sync-narration

Syncs a separately-recorded narration track onto a silent screen recording — pads audio with calculated pauses to match on-screen pacing (no voice during cursor movement), then burns styled captions. Use when the user provides a silent screen-recorded video plus a narration .mp3 and asks to sync/combine/caption them.

1시간 설치 수
1
GitHub Stars
5
업데이트
7월 26일