Command · Snap to Beats
edit.snapToBeats
Trims each clip's head and/or tail to the nearest beat of the beat grid when it is within the tolerance (linked partners follow).
- v1
- Capability EditSequence
- Tool
edit_snapToBeats
Request
{
"command": "edit.snapToBeats",
"params": {
"clips": [
42,
43
],
"tolerance": "00:00:00:06"
}
}Parameters
clips(integer | object (1..))[], min 1Required- Clips to snap.
edges`both` | `head` | `tail`- Which edges. Default both.
linkedboolean- Include linked partners (Premiere's linked selection). Default true.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
toleranceinteger | string- Largest move. Default: a quarter beat. Timecode in the sequence's rate ("00:01:02:03") or ticks.
Discussion
Trims each clip's head and/or tail to the nearest beat of the beat grid when it is within the tolerance (linked partners follow). Edges that cannot reach their beat (a neighbouring clip, too little media) are left and reported.
Run it with wabcut-cli cmd <project> --json, from an MCP client as edit_snapToBeats, or from an extension. See Edit commands for requests, references and results.
See also
edit.*
- edit.clear
Delete. Delete (Premiere Delete key): removes clips and leaves gaps.
- edit.cutToBeats
Cut to Beats. 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).
- edit.insertFromSource
Insert from Source. Insert edit from the source (Premiere ','), with three-point editing: the source marks (stored on the media unless given), the sequence In/Out marks and the playhead decide where it goes and what it uses.
- edit.overwriteFromSource
Overwrite from Source. Overwrite edit from the source (Premiere '.'), with three-point editing like edit.insertFromSource: replaces what is on the patched tracks; nothing moves.