create_track
Insert a MIDI, audio, or return track into an Ableton Live set and get its resolved track index. Specify kind, name, and position; use -1 to append without shifting existing tracks.
Instructions
Insert a MIDI, audio, or return track and return its resolved index.
Returns:
Dictionary with the resolved index of the new track, its kind and name, and
the track count before and after.
Note:
Inserting at index N shifts the track that was at N, and every track after it, up
by one. Every track index held from before the call is then wrong, including ones
in a plan not yet executed. Append with -1 where the position does not matter, and
otherwise take the resolved index out of this answer rather than assuming it.
Creating a track does not put an instrument on it. Select it and call
load_device for that, then create_clip for something to play.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | What to create: 'midi' for a MIDI track, 'audio' for an audio track, 'return' for a send return. A return track is appended to song.return_tracks and cannot be named or positioned here. | midi |
| name | No | Name for the new MIDI or audio track. Empty leaves Live to name it, which produces a default like '3-MIDI'. | |
| index | No | Where to insert it in song.tracks. -1 appends at the end, which is the only value that leaves existing track indices alone. Ignored for a return track. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||