build_arrangement
Lays out your Ableton Arrangement section by section, tiling active Session clips per section with named locators and clip-envelope automation applied as track automation.
Instructions
Build the Arrangement from Session clips, section by section, like a producer laying out a track: each section plays the clips of the tracks whose role is active there, tiled to fill it, with a named locator at its start. Clip envelopes (see write_clip_evolution) come along as track automation, so a filter build or a reverb swell plays in the Arrangement.
Use a template (techno_dj, techno_64, minimal, house; see
arrangement_templates) or your own sections: [{"name", "bars",
"roles": [...]} or {"name", "bars", "play": {"track_index": slot}}].
Track roles come from track names (kick, drums, hats, perc, rumble, bass,
chords, pad, lead, vocal, fx) unless track_roles {"track_index": role}
overrides them. section_slots {"Section name": {"track_index": slot}}
picks another clip for a section (e.g. the automated build variant).
Run with dry_run=true first to see the plan.
Parameters:
template / sections: Structure to build
track_roles: Role per track index, overriding names
start_bar: Arrangement bar to start at (0 = beginning)
default_slot: Session slot used by default for every track
section_slots: Per-section slot overrides
locators: Add a locator at each section (transport must be stopped)
dry_run: Only return the plan
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "build_arrangement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| locators | No | ||
| sections | No | ||
| template | No | ||
| start_bar | No | ||
| track_roles | No | ||
| default_slot | No | ||
| section_slots | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |