Skip to content

keryx music

Generate an instrumental music bed with ElevenLabs Music — a faithful port of the blog gen-music.py. The bed prompt defaults to the reel theme's music block unless overridden.

keryx music [--prompt "tone description"] [--length 35s] [--out bed.mp3] [--theme <reel-theme>]
Flag Meaning Default
--prompt the bed description theme music.prompt
--length bed length (Go duration, e.g. 35s) 35s
--out output MP3 path bed.mp3
--theme reel theme supplying the music defaults the configured reel default

The credential comes from the ELEVENLABS_API_TOKEN environment variable. Add --output json for machine-readable output.

keryx music --prompt "restrained editorial bed, sober and understated" --length 38s --out bed.mp3

Notes

  • Provider-selected via providers.music (default ElevenLabs Music) — see Providers.
  • In the full reel pipeline the bed is requested at the reel's computed total length (derived from the VO-driven timeline), not a hand-set value (spec §3.1); --length is for standalone use.
  • Take management (keryx music select) lands with the authoring loop (Phase 1.5).

Take management

keryx music select <take> --workspace <slug>

Generate candidate beds, then promote one:

keryx music --workspace <slug> --takes <K>     # K candidate beds → music/takes/
keryx music select <take> --workspace <slug>    # promote one → music.mp3

--takes uses the reel theme's music.prompt.