Track tools

Tools that resolve, create, and edit tracks. live_find_track turns a human name into a stable id the other tools take. Naming a freshly created track is a separate call (the SDK creates, then configures, as two undo steps).

live_find_track read

Resolve a human track name or substring (case-insensitive) to the stable track ids that match, each with its name and type. Returns count 0 with a hint when nothing matches; that is a valid answer, not an error. Use the returned id with live_list_clips / live_set_track_props.

Parameter	Type	Required	Description
query	string	yes	Track name or substring, case-insensitive

live_create_track write

Create one empty MIDI or audio track at the end of the track list. One undo step. The track is unnamed; to name it, call live_set_track_props with the returned track id (the SDK cannot create and configure in a single undo step). Returns the new track id, name, and type.

Parameter	Type	Required	Description
kind	"midi" | "audio"	yes	Track type to create

live_set_track_props write

Set a track's name, mute, solo, and / or arm in ONE undo step. Provide at least one property; only the given keys are written. Returns the post-write track state. Use the track id from live_find_track or live_get_song_overview.

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