Command · Cut to Beats

edit.cutToBeats

Music-video assembly: places the given clips' media (from each clip's source In) and media items (from their start) one after another, each lasting beatsPerCut beats of the beat grid, starting at the first beat at or after "at" (the playhead).

• v1
• Capability EditSequence
• Tool edit_cutToBeats

Request

{
  "command": "edit.cutToBeats",
  "params": {
    "at": "00:00:00:00",
    "beatsPerCut": 2,
    "media": [
      "Shot 1",
      "Shot 2",
      "Shot 3"
    ]
  }
}

Parameters

atinteger | stringRequired

Start at the first beat at or after this time (the playhead). Timecode in the sequence's rate ("00:01:02:03") or ticks.

audioTrackstring | integer (1..)

Audio destination; none by default. "V1" (bottom video track), "A2", ... or a track id.

beatsPerCutinteger (1..64)

Beats per clip. Default 4 (a bar).

clips(integer | object (1..))[], min 0

Clips whose media to use, in order.

media(integer | string (1..))[]

Media items to use, after the clips.

sequenceinteger (1..)

Sequence id; only needed when the project has several.

videoTrackstring | integer (1..)

Video destination. Default V1. "V1" (bottom video track), "A2", ... or a track id.

Discussion

Run it with wabcut-cli cmd <project> --json, from an MCP client as edit_cutToBeats, or from an extension. See Edit commands for requests, references and results.