write_automation
Automate clip parameters in Ableton Live by defining envelope points or shapes (ramp, sine, steps) over time; returns sampled values.
Instructions
Automate a parameter inside a clip (clip envelope) from points or a shape; returns sampled values.
parameter: "volume", "pan", "send:A", or a device parameter with device. Times are clip beats or
"bar.beat.sixteenth" (1.1.1 = clip start). points: [{time, value}]; two points at one time make a jump.
shape: {type: ramp|sine|triangle|square|saw|steps, from, to, period ("1 bar"), steps: [values]} over
start..end (default: the clip loop). units "display": dB, Hz, ms, %, pan -1..1, item names; "raw":
internal values. clear_range replaces breakpoints in the range. Envelopes loop with the clip and
travel into the arrangement; arrangement clips can only edit envelopes they already carry.
Example: write_automation("Pad", "volume", slot=0, shape={"type": "ramp", "from": -24, "to": 0}).
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": "<track>",
"parameter": "<parameter>"
},
"name": "write_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| slot | No | ||
| shape | No | ||
| start | No | ||
| track | Yes | ||
| units | No | display | |
| device | No | ||
| points | No | ||
| parameter | Yes | ||
| clear_range | No | ||
| arrangement_clip | No |