Device tools

Tools for the device chain. live_insert_device adds a built-in Live device and returns its parameters with ids, so the model can immediately set one with live_set_param. Built-in Live devices only: third-party and VST plugins are not addressable in this beta. A parameter value must fall within the parameter’s own min and max, which the tool reports and enforces.

live_insert_device write

Insert a built-in Live device (e.g. Reverb, EQ Eight) onto a track at a chain index. One undo step. Built-in devices only; third-party / VST is not supported and an unknown name is rejected. Returns the new device id and its parameter ids, ready for live_set_param.

Parameter	Type	Required	Description
trackId	string	yes	Stable track id from live_find_track / overview, e.g. 'track:2'
deviceName	string	yes	Exact built-in Live device name, e.g. 'Reverb'. Built-in devices only; third-party / VST not supported.
index	integer	yes	Insert position in the track's device chain

live_set_param write

Set one device parameter to a value (which must fall within the parameter's own min..max). One undo step. Get a parameter id from the ableton://track/{i} resource or from live_insert_device. Returns the parameter name, the value written, and its min / max.

Parameter	Type	Required	Description
paramId	string	yes	Stable parameter id, e.g. 'track:2/device:1/param:6'
value	number	yes	Target value; must fall within the parameter's own min..max