Skip to content

Commands

track.add

Adds an empty track at a place in the track order.

Last updated:

Adds a visual or audio track. It goes on top by default; position bottom, above or below another track places it elsewhere. The first track in the order is the top layer.

Arguments#

ArgumentTypeRequiredDescription
abovestringnoPlace the track directly over this track.
belowstringnoPlace the track directly under this track.
idstringno
kindvisual, audioyes
namestringno
positiontop, bottomnotop (default) or bottom.

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": "track.add",
  "args": {
    "id": "trk_a1b2c3d4e5",
    "kind": "visual",
    "name": "Captions"
  }
}

Errors#

E_VALIDATION, E_NOT_FOUND, E_ID_EXISTS, E_LIMIT

Scope and phase#

Scope edit, phase prototype. Run vukem-video command:help track.add for the same description from the binary.