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 (the default ffmpeg); on afmpeg the pick ranks on duration alone.

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

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.