arrange
Copy a Session clip onto the Arrangement timeline at a precise beat, turning a session idea into an arrangement while preserving the original clip.
Instructions
Copy a Session clip onto the Arrangement timeline at a beat position.
A copy, not a move: the Session clip stays in its slot and the two are separate
clips afterwards, so editing one leaves the other alone. This is how a Session
idea becomes an arrangement, and how clip automation written by write_automation
reaches the Arrangement timeline.
Returns:
Dictionary with the placement status, the destination track, and the
Arrangement clip count before and after.
Note:
Call it once per placement. Repeating the same call adds another copy at the
same beat rather than replacing the first, so a retry after an unclear result
needs the clip count in this answer checked first.
Use create_clip and write_clip_notes to build the source clip, and
set_arrangement_time then play to hear where it landed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slot | Yes | Clip slot index in track.clip_slots, counted from 0. A slot index is the scene the clip sits in, so slot 2 is the third scene down. | |
| track | Yes | Track index in song.tracks, counted from 0. | |
| at_beat | Yes | Where the copy starts on the Arrangement timeline, in beats from the start of the song. Fractional beats are accepted. | |
| to_track | No | Track index to place the copy on. Omit to use the source track, which is the usual case. A MIDI clip needs a MIDI destination. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||