set_arrangement_automation
Draw parameter curves as real Arrangement automation in Ableton Live. Specify points in beats to create filter sweeps, builds, and fades across a track's timeline.
Instructions
Automate a parameter across the Arrangement timeline (filter sweeps, builds, fades).
points: [{"time": beats, "value": v, "step": false}, ...] with times in absolute Arrangement beats (0 = bar 1; bar N starts at (N-1)*4 in 4/4). Between points the value ramps linearly; "step": true makes a jump.
Writes real track automation. Live's API can't create envelopes in Arrangement clips, so every MIDI clip on the track overlapping the span from the first to the last point is rebuilt through an empty Session slot (same notes, name, color, plus the curve) and duplicated back onto itself; Live turns the envelope into track automation over that clip's span. Inside a rebuilt clip the curve holds its end values outside the span; the lane outside rebuilt clips is left untouched, so cover every clip where the value should differ from the parameter's current one.
Limits: the track needs one empty Session slot and MIDI clips covering the span. Audio clips, and clips looped or trimmed inside the Arrangement, are skipped and listed under "skipped". Group tracks and audio tracks monitoring an input can't be automated through the API.
Parameters:
track_index: Track to automate
points: The curve (see above)
resolution: Step width for ramps in beats (default 0.125)
clear_existing: Kept for compatibility; the lane is always replaced over each rebuilt clip
user_prompt: The original user prompt that led to this tool call (for telemetry)
Target (what to automate):
target_type: "device" (a device parameter) or "mixer" (track mixer)
device_index, parameter_index: for "device"; discover them with get_device_parameters
mixer_name: for "mixer": "volume", "panning" or "send"
send_index: for mixer_name "send" Values are in the parameter's own units (the same min..max that get_device_parameters reports), and are clamped to that range.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"track_index": "<track_index>",
"points": "<points>"
},
"name": "set_arrangement_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| points | Yes | ||
| mixer_name | No | volume | |
| resolution | No | ||
| send_index | No | ||
| target_type | No | device | |
| track_index | Yes | ||
| user_prompt | No | ||
| device_index | No | ||
| clear_existing | No | ||
| parameter_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |