Skip to content

keryx voice pick

Description

Promote a VO take to the selected slot (vo/NN.mp3) for a storyboard line, so reel build uses it and the line's timing is set. Re-runnable; only the named line's selection changes.

Pick the take yourself, or let stilt screening choose the cleanest one:

keryx voice pick 5 2 --workspace my-post     # promote take 2 of line 5 (you chose)
keryx voice pick --best 5 --workspace my-post # auto-promote line 5's cleanest take

Usage

keryx voice pick <line> <take> --workspace <slug>
keryx voice pick --best <line> --workspace <slug>

Behaviour

  • <line> <take>: promotes the take you name.
  • --best <line>: stilt-screens the line (duration deviation + excess internal silence, see voice takes --screen) and promotes the cleanest take for you (spec 0023 R-GEN-39). It reports the picked take, and warns when every take on the line reads over-paused — a signal to reword/respell rather than trust the auto-pick.
  • Silence detection needs the render backend's silencedetect, which the default afmpeg backend does not have — so the pick ranks on duration alone unless you set providers.render: ffmpeg. It says which it did on stderr.

Flags

Flag Description Default Required
--workspace reel workspace slug
--force overwrite a locked (approved) asset false
--best auto-promote the cleanest take for this storyboard line (stilt-screened) 0
--lock approve the line as well, so a re-roll refuses without --force false

Locked assets

If the line has been approved with reel lock vo <line>, a pick is refused to protect the approved read — pass --force to overwrite it deliberately.

--lock goes the other way: it picks and approves in one command, so the line is frozen the moment you choose the take.

keryx voice pick 3 2 --workspace launch --lock
keryx voice pick --best 3 --workspace launch --lock   # works with --best too

That exists for recorded reads (spec 0030). A hand-recorded take is usually the canonical "final, do not regenerate" one the moment it is picked, and saying so in a second command is a second command that gets forgotten. Locking is still a separate verb everywhere else, because a generated take is normally auditioned against its siblings before anyone commits to it.

Unlock with reel unlock vo <line>.