Clip tools

Tools that work at the clip level. live_list_clips reports both session slots (including empty ones, so the model knows where it can create) and arrangement clips, each with the id you pass to the note tools.

live_list_clips read

List the clips on one track: Session-view slots (empty slots included, so you can see where to create a clip) and Arrangement clips, each with its stable id, name, and kind (midi / audio / empty). Pass a clip id to live_get_notes / live_set_notes, or a slot id to live_create_midi_clip.

Parameter	Type	Required	Description
trackId	string	yes	Stable track id from live_find_track / overview, e.g. 'track:2'

live_create_midi_clip write

Create an empty MIDI clip in a Session clip slot (given a length in beats, minimum 0.25), ready for live_set_notes. One undo step. The slot id must be an empty slot on a MIDI track (from live_list_clips). Returns the new clip id and slot id.

Parameter	Type	Required	Description
slotId	string	yes	Stable clip-slot id from live_list_clips, e.g. 'track:2/clipslot:4'
lengthBeats	number	yes	Clip length in beats, minimum 0.25