keryx voice gen¶
Description¶
Synthesize voice-over narration. Two modes:
- Standalone:
--text "…"narrates a single line to an mp3 (--out, defaultvo.mp3). - Take mode:
--takes N --workspace <slug>generates N candidate takes for a storyboard line (--line) into the workspace, for review withvoice pick.
The voice id and all clone settings default to the resolved reel theme's voice
and can be overridden per-run. The full ElevenLabs knob set is exposed:
--stability, --similarity, --style (expression/exaggeration; higher drifts
the accent), and --speed (0.7 slow … 1.2 fast). A storyboard card may also
carry a per-line voice override for any of these.
For multi-author reels, a registered voice clone (config voices.<name>) can
narrate specific lines: set the card's voice.speaker to that name and it becomes
the line's base voice (overriding the reel theme's voice). Register a co-author's
clone as another voices entry.
Usage¶
Flags¶
| Flag | Description | Default | Required |
|---|---|---|---|
--text |
line to narrate (standalone mode) | ||
--out |
output mp3 path | vo.mp3 |
|
--voice |
override the clone voice id | ||
--stability |
override voice stability (0–1) | ||
--similarity |
override voice similarity (0–1) | ||
--style |
voice style/exaggeration (0–1; higher = more expressive, can drift accent) | 0 |
|
--speed |
speech rate (0.7 slow … 1.2 fast) | 1.0 |
|
--theme |
reel theme for voice defaults | ||
--workspace |
reel workspace slug (take mode) | ||
--line |
storyboard line index for take generation | 0 |
|
--takes |
number of candidate takes to generate | 0 |