Check if Ableton Live is connected and responsive.

Get the current playback position and transport state.

Get detailed information about the current Ableton session

Get detailed information about a specific track in Ableton.

Parameters:

• track_index: The index of the track to get information about

Get the color of a track.

Parameters:

• track_index: The index of the track

Get the color of a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot

Get the color of a scene.

Parameters:

• scene_index: The index of the scene

Get the loop settings of a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot

Get the send level from a track to a return track.

Parameters:

• track_index: The index of the source track

• send_index: The index of the send (0=A, 1=B, etc.)

Create a new MIDI track in the Ableton session.

Parameters:

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

Create a new audio 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: The index of the track to rename

• name: The new name for the track

Set the mute state of a track.

Parameters:

• track_index: The index of the track

• mute: True to mute, False to unmute

Set the solo state of a track.

Parameters:

• track_index: The index of the track

• solo: True to solo, False to unsolo

Set the arm (record enable) state of a track.

Parameters:

• track_index: The index of the track

• arm: True to arm for recording, False to disarm

Set the volume of a track.

Parameters:

• track_index: The index of the track

• volume: Volume level from 0.0 (silent) to 1.0 (unity gain). 0.85 is Ableton's default.

Set the panning of a track.

Parameters:

• track_index: The index of the track

• pan: Pan position from -1.0 (full left) to 1.0 (full right). 0.0 is center.

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

Parameters:

• track_index: The index of the track to create the clip in

• clip_index: The index of the clip slot to create the clip in

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

Delete a clip from a clip slot.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Get all MIDI notes from a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Add MIDI notes to a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

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

Set the name of a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• 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: The index of the track to load the instrument on

• 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: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Stop playing a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Start playing the Ableton session.

Stop playing the Ableton session.

Get all parameters from a device on a track.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device on the track

Set a device parameter value.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device on the track

• parameter_index: The index of the parameter to set

• value: The new value for the parameter (will be clamped to valid range)

Get information about all scenes in the session.

Create a new scene.

Parameters:

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

Delete a scene.

Parameters:

• scene_index: The index of the scene to delete

Fire (trigger) a scene to play all clips in that row.

Parameters:

• scene_index: The index of the scene to fire

Stop all clips in a scene.

Parameters:

• scene_index: The index of the scene to stop

Set the name of a scene.

Parameters:

• scene_index: The index of the scene to rename

• name: The new name for the scene

Set the color of a scene.

Parameters:

• scene_index: The index of the scene

• color: The color index (0-69 in Ableton's color palette)

Duplicate a scene.

Parameters:

• scene_index: The index of the scene to duplicate

Delete a track.

Parameters:

• track_index: The index of the track to delete

Duplicate a track with all its clips and devices.

Parameters:

• track_index: The index of the track to duplicate

Freeze a track (render all devices to audio for CPU optimization).

Parameters:

• track_index: The index of the track to freeze

Flatten a frozen track (convert freeze to permanent audio). The track must be frozen first.

Parameters:

• track_index: The index of the track to flatten

Unarm all tracks in the session. Useful before recording to ensure only specific tracks will record.

Move a device one position to the left in the device chain.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device to move

Move a device one position to the right in the device chain.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device to move

Set the color of a track.

Parameters:

• track_index: The index of the track

• color: The color index (0-69 in Ableton's color palette)

Toggle a device on or off.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device on the track

Delete a device from a track.

Parameters:

• track_index: The index of the track containing the device

• device_index: The index of the device to delete

Duplicate a clip to the next empty slot.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Set the color of a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• color: The color index (0-69 in Ableton's color palette)

Set the loop settings of a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• loop_start: The start point of the loop in beats

• loop_end: The end point of the loop in beats

• looping: Whether looping is enabled

Remove notes from a clip within a specified range.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• from_time: Start time in beats

• time_span: Duration in beats

• from_pitch: Starting MIDI pitch (0-127)

• pitch_span: Number of pitches to include

Remove all notes from a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

Transpose all notes in a clip.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• semitones: Number of semitones to transpose (positive = up, negative = down)

Undo the last operation in Ableton.

Redo the last undone operation in Ableton.

Get information about all return (aux) tracks.

Get detailed information about a return track.

Parameters:

• return_index: The index of the return track

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

Parameters:

• track_index: The index of the source track

• send_index: The index of the send (corresponds to return track index)

• level: The send level (0.0 to 1.0)

Set the volume of a return track.

Parameters:

• return_index: The index of the return track

• volume: The volume level (0.0 to 1.0)

Set the panning of a return track.

Parameters:

• return_index: The index of the return track

• pan: The pan position (-1.0 = left, 0.0 = center, 1.0 = right)

Get information about the current view state (selected track, scene, etc.).

Focus a specific view in Ableton.

Parameters:

• view_name: The name of the view (Session, Arranger, Detail, etc.)

Select a track.

Parameters:

• track_index: The index of the track to select

Select a scene.

Parameters:

• scene_index: The index of the scene to select

Select a clip slot.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot

Start recording in Ableton.

Stop recording in Ableton.

Toggle session record mode.

Toggle arrangement record mode.

Set overdub mode.

Parameters:

• enabled: True to enable overdub, False to disable

Capture MIDI that was played recently (like Ableton's Capture feature).

Get the length and loop settings of the arrangement.

Set the arrangement loop region.

Parameters:

• start: Loop start position in beats

• end: Loop end position in beats

• enabled: Whether to enable looping

Jump to a specific time in the arrangement.

Parameters:

• time: Position in beats to jump to

Get all locators/cue points in the arrangement.

Create a new locator/cue point.

Parameters:

• time: Position in beats for the locator

• name: Name for the locator

Delete a locator.

Parameters:

• locator_index: Index of the locator to delete

Get the input routing of a track.

Parameters:

• track_index: The index of the track

Get the output routing of a track.

Parameters:

• track_index: The index of the track

Get available input routing options for a track.

Parameters:

• track_index: The index of the track

Get available output routing options for a track.

Parameters:

• track_index: The index of the track

Set the input routing of a track.

Parameters:

• track_index: The index of the track

• routing_type: The input routing type (use get_available_inputs to see options)

• routing_channel: The input channel (optional)

Set the output routing of a track.

Parameters:

• track_index: The index of the track

• routing_type: The output routing type (use get_available_outputs to see options)

• routing_channel: The output channel (optional)

Get the current CPU load of Ableton.

Get the file path of the current session.

Check if the session has unsaved changes.

Get the current metronome state.

Turn the metronome on or off.

Parameters:

• enabled: True to enable, False to disable

Get the notes in a musical scale.

Parameters:

• root: MIDI note number for the root (0-127, where 60 = middle C)

• scale_type: Type of scale (major, minor, dorian, phrygian, lydian, mixolydian, locrian, harmonic_minor, melodic_minor, pentatonic_major, pentatonic_minor, blues, chromatic)

Quantize notes in a clip to a grid.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• grid: Grid size in beats (0.25 = 16th notes, 0.5 = 8th notes, 1.0 = quarter notes)

Add random timing variation to notes in a clip for a more human feel.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• amount: Amount of timing variation in beats (0.05 = subtle, 0.1 = moderate, 0.2 = heavy)

Add random velocity variation to notes in a clip for a more human feel.

Parameters:

• track_index: The index of the track containing the clip

• clip_index: The index of the clip slot containing the clip

• amount: Amount of velocity variation (0.1 = +/-10%, 0.2 = +/-20%)

Generate a drum pattern and add it to a clip.

Parameters:

• track_index: The index of the track (should be a drum track)

• clip_index: The index of the clip slot

• style: Pattern style (basic, house, hiphop, dnb, random)

• length: Pattern length in beats

Generate a bassline pattern and add it to a clip.

Parameters:

• track_index: The index of the track (should be a bass track)

• clip_index: The index of the clip slot

• root: Root note MIDI number (36 = C1, common bass range)

• scale_type: Scale to use (minor, major, dorian, pentatonic_minor, blues)

• length: Pattern length in beats

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

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

Parameters:

• track_index: The index of the track to load on

• 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 information about the master track including volume, pan, and devices.

Set the master track volume.

Parameters:

• volume: Volume level from 0.0 (silent) to 1.0 (unity gain). 0.85 is Ableton's default.