Skip to content

Commands

caption.split

Splits a caption into two at a word boundary.

Last updated:

The right part starts with the word at before_word. Style and the linked clip are copied to it; transition_out moves to it. The cut falls at the start of that word, so the parts cover the original range.

Arguments#

ArgumentTypeRequiredDescription
before_wordintegeryesIndex of the first word of the right part. min 1
item_idstringyesA caption.
new_idstringnoThe id of the right part.

Example#

As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):

JSON
{
  "op": "caption.split",
  "args": {
    "before_word": 2,
    "item_id": "itm_s6t7v8w9x0",
    "new_id": "itm_c3d4e5f6g7"
  }
}

Errors#

E_VALIDATION, E_NOT_FOUND, E_TYPE_MISMATCH, E_ID_EXISTS, E_LIMIT

Scope and phase#

Scope edit, phase alpha. Run vukem-video command:help caption.split for the same description from the binary.