arrangement
Edit Ableton Live timeline clips, scenes, locators, and take lanes by listing, placing, copying, moving, creating, or deleting items.
Instructions
Work on the Arrangement timeline.
list: clips per track, locators, loop. place_scene: copy every clip of a Session scene to the timeline at a bar, in one undo step (envelopes come along as track automation). copy_clip: one Session or timeline clip to a bar. move_clip: a timeline clip (t0/a1) to another bar. create_clip: a MIDI clip on the timeline with notes (audio: create_audio_clip). delete_clip: by track, start and name. add_take_lane. add_locator, rename_locator, delete_locator. list shows each clip's address, type and the take lanes. Times answer as bar|beat ("17|1") and beats. Live cannot read Arrangement automation back.
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": {
"action": "<action>"
},
"name": "arrangement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip | No | For copy_clip and move_clip: a clip address instead of track and slot: t0/s2 (Session) or t0/a1 (a timeline clip from action list). | |
| name | No | Clip or locator name; for delete_clip the clip's name as a check. | |
| slot | No | For copy_clip: the Session slot to copy, from 0. | |
| notes | No | For create_clip: notes, as in write_clip. | |
| scene | No | For place_scene: scene number from 0 or its exact name. | |
| track | No | For copy_clip, create_clip, delete_clip, add_take_lane: t0, t1... | |
| action | Yes | What to do; see the tool description. | |
| at_bar | No | Where: bar number from 1, as Live shows it (17 = bar 17). | |
| locator | No | For rename_locator, delete_locator: the locator's name. | |
| at_beats | No | Where, in beats from the start, instead of at_bar. | |
| length_beats | No | For create_clip: length in beats. Empty: fit the notes. |