capture_session_to_arrangement
Capture a Session scene into the Arrangement for audio export. Automates arming Arrangement Record and printing the scene, so you can export your song.
Instructions
Record a Session scene into the Arrangement so the song can be exported.
Live's Export Audio/Video only renders the Arrangement, so a Session-view
loop must first be printed there. This automates the whole capture — no
manual Arrangement-record arming:
1. stop, rewind to 1.1.1, force Session Record off, and (if tighten_launch)
set clip-launch quantization to None for a tight start at bar 1,
2. arm Arrangement Record (the ● button),
3. fire scene `scene_index` — its clips begin printing into the Arrangement,
4. wait one full pass (`length_beats` + `tail_beats`), polling the playhead,
5. stop, disarm record, restore quantization, rewind, return to Arrangement.
length_beats = bars * time_signature_numerator (e.g. 128 bars of 4/4 = 512).
`tail_beats` lets the final notes ring before stopping. Re-recording the same
span overwrites the previously captured Arrangement region for the scene's
tracks, so re-exports stay clean.
wait=True (default) blocks until the pass finishes and returns the result.
wait=False arms + fires and returns immediately (then call stop_playback and
set_arrangement_record(False) yourself once the playhead reaches length_beats).
max_wait_seconds caps the blocking wait (0 = auto: one pass + 15 s headroom).Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | ||
| tail_beats | No | ||
| scene_index | Yes | ||
| length_beats | Yes | ||
| tighten_launch | No | ||
| max_wait_seconds | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |