Get detailed information about the current Ableton session

Get detailed information about a specific track in Ableton.

Parameters:

• track_index: Track number (1-based).

Create a new MIDI track in the Ableton session.

Parameters:

• index: The index to insert the track at (-1 = end of list)

Set the name of a track.

Parameters:

• track_index: Track number (1-based).

• name: The new name for the track.

Get the current fader volume and panning for a track.

Returns the raw normalized value, its min/max range, and the panning. Volume 0.85 = 0 dB unity gain. Use this before set_track_volume to understand the current state.

Parameters:

• track_index: Track number (1-based). Return tracks come after session tracks.

Set the mixer fader volume for a track directly.

This controls the actual track fader, not any device parameter.

Volume scale (normalized): 0.0 = silence 0.85 = 0 dB (unity gain, Ableton's default fader position) 1.0 = maximum (~+6 dB)

Parameters:

• track_index: Track number (1-based). Return tracks come after session tracks.

• volume: Normalized volume 0.0–1.0. Use 0.85 for unity (0 dB).

Set the mixer panning for a track.

Parameters:

• track_index: Track number (1-based).

• panning: -1.0 = full left, 0.0 = center, +1.0 = full right.

Create a new MIDI clip in the specified track and clip slot.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

• length: The length of the clip in beats (default: 4.0).

Add MIDI notes to a clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

• notes: List of note dictionaries, each with pitch, start_time, duration, velocity, and mute.

Set the name of a clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

• name: The new name for the clip.

Set the tempo of the Ableton session.

Parameters:

• tempo: The new tempo in BPM

Load an instrument or effect onto a track using its URI.

Parameters:

• track_index: Track number (1-based).

• uri: The URI of the instrument or effect to load (e.g., 'query:Synths#Instrument%20Rack:Bass:FileId_5116').

Start playing a clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Stop playing a clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Start playing the Ableton session.

Stop playing the Ableton session.

Get a hierarchical tree of browser categories from Ableton.

Parameters:

• category_type: Type of categories to get ('all', 'instruments', 'sounds', 'drums', 'audio_effects', 'midi_effects')

Get browser items at a specific path in Ableton's browser.

Parameters:

• path: Path in the format "category/folder/subfolder" where category is one of the available browser categories in Ableton

List discovered external plugins (VST/AU), optionally filtered by name query.

Parameters:

• query: Optional case-insensitive search string.

• max_results: Maximum number of plugins to display.

• refresh_cache: If True, force a rescan instead of using cached results.

Load an external plugin onto a track by plugin name (no URI required).

Parameters:

• track_index: Track number (1-based).

• plugin_name: Plugin name to match (e.g., "FabFilter Pro-Q 3").

• exact_match: If True, require exact normalized name match.

• refresh_cache: If True, force a rescan before matching.

Load a drum rack and then load a specific drum kit into it.

Parameters:

• track_index: Track number (1-based).

• rack_uri: The URI of the drum rack to load (e.g., 'Drums/Drum Rack').

• kit_path: Path to the drum kit inside the browser (e.g., 'drums/acoustic/kit1').

Get arrangement clips and transport state.

Parameters:

• track_index: Track number (1-based). 0 = all tracks.

List all cue points (locators) with bar positions.

Jump playback to a position.

Parameters:

• bar: Bar number (1-based). Takes precedence over beat.

• beat: Beat position (0-based).

Enable/disable arrangement loop and set region.

Parameters:

• enabled: Whether loop is on.

• start_bar: Loop start (1-based). Takes precedence over start_beat.

• end_bar: Loop end (1-based). Used with start_bar to compute length.

• start_beat: Loop start in beats.

• length_beats: Loop length in beats.

Jump to a cue point.

Parameters:

• direction: "next" or "prev"

• name: Cue point name to jump to.

Create a cue point at a position.

Parameters:

• bar: Bar number (1-based).

• beat: Beat position (0-based).

• name: Name for the cue point.

Delete a cue point at a position.

Parameters:

• bar: Bar number (1-based).

• beat: Beat position (0-based).

Create an empty MIDI clip in the arrangement.

Parameters:

• track_index: Track number (1-based).

• start_bar: Start bar (1-based). Takes precedence over start_beat.

• end_bar: End bar (1-based). Used with start_bar to compute length.

• start_beat: Start position in beats.

• length_beats: Clip length in beats.

• name: Optional clip name.

Place an audio file as a clip in the arrangement.

Parameters:

• track_index: Track number (1-based).

• file_path: Path to the audio file.

• start_bar: Start bar (1-based).

• start_beat: Start position in beats.

Copy a session clip to the arrangement.

Parameters:

• track_index: Track number (1-based).

• clip_index: Session clip slot (1-based).

• destination_bar: Destination bar (1-based).

• destination_beat: Destination beat.

Delete an arrangement clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip position in arrangement (1-based).

• clip_name: Clip name (alternative to clip_index).

Set properties on an arrangement clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip position (1-based).

• clip_name: Clip name (alternative to clip_index).

• name: New clip name.

• muted: Mute state.

• color: Color (0x00RRGGBB).

• looping: Loop on/off.

• loop_start: Loop start in beats.

• loop_end: Loop end in beats.

• gain: Audio gain (0.0-1.0).

• pitch_coarse: Semitone pitch shift (-48 to 48).

• pitch_fine: Fine pitch shift (-50 to 49 cents).

• warping: Warp on/off.

• warp_mode: Warp mode (0-6).

Switch Ableton's main view.

Parameters:

• view: View name. Options: Arranger, Session, Detail, Detail/Clip, Detail/DeviceChain, Browser.

Control the arrangement view.

Parameters:

• action: One of: zoom_in, zoom_out, scroll_left, scroll_right, follow_on, follow_off, collapse_track, expand_track.

• track_index: Track number (1-based, for collapse/expand).

Create or clear automation envelopes on arrangement clips.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip position (1-based).

• clip_name: Clip name (alternative to clip_index).

• action: "create", "clear", or "clear_all".

• parameter_name: Parameter to automate (e.g., "volume", "panning").

List parameters for a device on a track.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number on the track (1-based, default 1).

• chain_index: Chain number inside a rack (1-based, 0 = no chain).

• category: Filter by category name (returns detail for that category).

• show_all: If True, return all parameters in detail mode.

Default mode returns a summary grouped by category with counts. Specify category or show_all=True for full parameter details.

Set a device parameter value.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based, default 1).

• chain_index: Chain number inside a rack (1-based, 0 = no chain).

• parameter_name: Parameter name, friendly alias, or partial match.

• parameter_index: Parameter number (1-based, alternative to name).

• value: Normalized value 0.0-1.0.

Enable (activate) a device on a track.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based). Use 0 if using device_name.

• device_name: Device name (alternative to device_index).

• chain_index: Chain number inside a rack (1-based, 0 = no chain).

Disable (bypass) a device on a track.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based). Use 0 if using device_name.

• device_name: Device name (alternative to device_index).

• chain_index: Chain number inside a rack (1-based, 0 = no chain).

List chains in a rack device, or devices within a specific chain.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based, default 1).

• chain_index: Chain number (1-based) to drill into. 0 = list all chains.

List filled drum pads in a Drum Rack.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based, default 1).

Delete a device from a track.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based).

• device_name: Device name (alternative to device_index).

Check whether session tracks can be deleted right now.

Returns a quick safety summary so agents can avoid attempting deletes when Ableton's minimum-track constraint would block them.

Delete a track from the Ableton session.

Parameters:

• track_index: Track number (1-based). Use 0 to resolve by name instead.

• track_name: Track name (alternative to track_index). If both are given, track_index takes priority.

Navigate device presets (next/previous/current).

Parameters:

• track_index: Track number (1-based).

• device_index: Device number (1-based, default 1).

• chain_index: Chain number inside a rack (1-based, 0 = no chain).

• direction: "next", "previous", or "current".

Read the MIDI notes of a Session clip.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Remove every MIDI note from a Session clip, leaving the clip in place.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Replace a clip's contents: clear every existing note, then write these.

add_notes_to_clip only appends. This clears first, so the clip ends up with exactly the notes given.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

• notes: Note dicts with pitch, start_time, duration, velocity, mute.

Delete the clip in a Session slot, freeing the slot.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Create a new audio track.

Parameters:

• index: Insert position (-1 = end of list).

Dump the whole project state in one call: tracks, clips, devices, scenes, returns, master and cue points.

Parameters:

• include_notes: Include MIDI notes of every clip (large output).

• include_params: Include every device parameter (very large output).

Mute or unmute a track.

Parameters:

• track_index: Track number (1-based). Return tracks come after session tracks.

• mute: True to mute, False to unmute.

Solo or unsolo a track.

Parameters:

• track_index: Track number (1-based).

• solo: True to solo, False to clear.

Arm or disarm a track for recording. Group and return tracks cannot be armed.

Parameters:

• track_index: Track number (1-based).

• arm: True to arm, False to disarm.

Set one send level from a track to a return track.

Parameters:

• track_index: Track number (1-based).

• send_index: Send slot (1-based; send 1 feeds return A, 2 feeds B, ...).

• value: Normalized 0.0 (off) to 1.0 (max).

Report what a device object actually exposes in the running build of Live.

Device-specific classes (WavetableDevice, SimplerDevice, ...) carry members that never appear in the parameter list. Use this to find them.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number on the track (1-based).

• chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Read a Wavetable's modulation matrix, wavetable selection and voicing.

None of this appears in get_device_parameters - it lives on the WavetableDevice object itself.

Parameters:

• track_index: Track number (1-based).

• device_index: Device number on the track (1-based).

• chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Set a Wavetable property that is not a device parameter.

Writable names: oscillator_1_wavetable_category / oscillator_1_wavetable_index oscillator_2_wavetable_category / oscillator_2_wavetable_index oscillator_1_effect_mode / oscillator_2_effect_mode (0=None 1=FM 2=Classic 3=Modern) filter_routing (0=Serial 1=Parallel 2=Split) mono_poly (0=Mono 1=Poly) poly_voices, unison_mode, unison_voice_count

Parameters:

• track_index: Track number (1-based).

• name: Property name from the list above.

• value: Integer value.

• device_index: Device number on the track (1-based).

• chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Make a parameter a modulation target in Wavetable's matrix.

Reports which device parameters appeared as a result, which shows whether the matrix amounts become ordinary automatable parameters.

Parameters:

• track_index: Track number (1-based).

• parameter_name: Target parameter name (or use parameter_index).

• parameter_index: Target parameter number (1-based).

• device_index: Device number on the track (1-based).

• chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Set one cell of Wavetable's modulation matrix.

Sources: amp_envelope, envelope_2, envelope_3, lfo_1, lfo_2, midi_note, midi_velocity, midi_mod_wheel, midi_pitch_bend, midi_channel_pressure, midi_random.

Live 11's API documented no setter for this; if this build has none the call reports that rather than failing silently.

Parameters:

• track_index: Track number (1-based).

• target_index: Matrix target index from get_wavetable_state.

• source: Modulation source name.

• value: Modulation amount.

• device_index: Device number on the track (1-based).

• chain_index: Chain number inside a rack (1-based, 0 = not in a rack).

Read a Session clip's Clip-panel properties.

Covers Transpose, Clip Gain, Loop Position/Length, Start/End, warping and whether the clip is deactivated. Audio-only properties are omitted for MIDI clips rather than failing.

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

Set one property on a Session clip.

Writable names: name - clip name muted - True deactivates the clip (the "0" key in Live) color - clip colour as an integer pitch_coarse - Transpose in semitones pitch_fine - fine tune in cents looping - loop on/off loop_start / loop_end - Loop Position and end, in beats start_marker / end_marker - clip Start/End, in beats gain - Clip Gain (audio clips) warping - warp on/off (audio clips) warp_mode - warp algorithm (audio clips) velocity_amount - velocity-to-volume amount (MIDI clips)

Parameters:

• track_index: Track number (1-based).

• clip_index: Clip slot number (1-based).

• property_name: One of the names above.

• value: New value; type depends on the property.

List every scene with its name, state and which clips it holds.

A scene is a row of the Session grid. Use this to see which clips would launch together.

Launch a scene: every clip in that row starts, and tracks whose slot in the row is empty are stopped.

Parameters:

• scene_index: Scene number (1-based).

Insert a new scene.

Parameters:

• index: Position (1-based), or -1 to append at the end.

Delete a scene and everything in that row.

Parameters:

• scene_index: Scene number (1-based).

Duplicate a scene, inserting the copy directly below it.

Parameters:

• scene_index: Scene number (1-based).

Set a scene's name, colour, tempo or time signature.

Writable names: name, color, tempo, time_signature_numerator, time_signature_denominator.

Writing tempo or a time signature from the API also switches that scene control on, so no separate enable step is needed.

Parameters:

• scene_index: Scene number (1-based).

• property_name: One of the names above.

• value: New value.

Undo the last action in Live.

Redo the last undone action in Live.