LOM - The Live Object Model

Objects which comprise the Live API described by their structure, properties and functions. The Live Object Model lists a number of Live object classes with their properties and functions, as well as their parent-child relations through which a hierarchy is formed. Please refer to the Live API overview chapterfor definitions of the basic Live API terms and a list of the Max objects used to access it.

This document refers to Ableton Live version 12.1

Object Model Overview

Click on the classes to navigate to their description.

API Objects

ItemDescription
ApplicationThis class represents the Live application. It is reachable by the root path live_app ...
Application.ViewThis class represents the aspects of the Live application related to viewing the application....
ChainThis class represents a group device chain in Live.
ChainMixerDeviceThis class represents a chain's mixer device in Live.
ClipThis class represents a clip in Live. It can be either an audio clip or a MIDI clip in the Arr...
Clip.ViewRepresenting the view aspects of a Clip.
ClipSlotThis class represents an entry in Live's Session View matrix. The properties ...
CompressorDeviceThis class represents a Compressor device in Live. A CompressorDevice shares all of the ch...
ControlSurfaceA ControlSurface can be reached either directly by the root path control_surfaces N or by g...
CuePointRepresents a locator in the Arrangement View.
DeviceThis class represents a MIDI or audio device in Live.
Device.ViewRepresenting the view aspects of a Device.
DeviceIOThis class represents an input or output bus of a Live device.
DeviceParameterThis class represents an (automatable) parameter within a MIDI or audio device. To modify a de...
DriftDeviceThis class represents an instance of a Drift device in Live. A DriftDevice has all the...
DrumCellDeviceThis class represents an instance of a Drum Sampler device in Live. A DrumCell has all...
DrumChainThis class represents a Drum Rack device chain in Live. A DrumChain is a type ...
DrumPadThis class represents a Drum Rack pad in Live.
Eq8DeviceThis class represents an instance of an EQ Eight device in Live. An Eq8Device has all ...
Eq8Device.ViewRepresents the view aspects of an Eq8Device. An Eq8Device.View has all the children, p...
GrooveThis class represents a groove in Live. Available since Live 11.0. ...
GroovePoolThis class represents the groove pool in Live. It provides access to the current set's list of groov...
HybridReverbDeviceThis class represents an instance of a Hybrid Reverb device in Live. A HybridReverbDev...
LooperDeviceThis class represents an instance of a Looper device in Live. An LooperDevice has all ...
MaxDeviceThis class represents a Max for Live device in Live. A MaxDevice is a type of Device...
MeldDeviceThis class represents an instance of a Meld device in Live. A MeldDevice has all the p...
MixerDeviceThis class represents a mixer device in Live. It provides access to volume, panning and other ...
PluginDeviceThis class represents a plug-in device. A PluginDevice is a type of Device, meaning ...
RackDeviceThis class represents a Live Rack Device. A RackDevice is a type of Device, meaning th...
RackDevice.ViewRepresents the view aspects of a Rack Device. A RackDevice.View is a type of Device.Vi...
RoarDeviceThis class represents an instance of a Roar device in Live. A RoarDevice has all the p...
SampleThis class represents a sample file loaded into Simpler.
SceneThis class represents a series of clip slots in Live's Session View matrix....
ShifterDeviceThis class represents an instance of the Shifter audio effect. A ShifterDevice is a ty...
SimplerDeviceThis class represents an instance of Simpler. A SimplerDevice is a type of device, mea...
SimplerDevice.ViewRepresents the view aspects of a SimplerDevice. A SimplerDevice.View is a type of Device.V...
SongThis class represents a Live Set. The current Live Set is reachable by the root path li...
Song.ViewThis class represents the view aspects of a Live document: the Session and Arrangement Views....
SpectralResonatorDeviceThis class represents an instance of a Spectral Resonator device in Live. An SpectralR...
this_deviceThis root path represents the device containing the live.path object to which the ...
TrackThis class represents a track in Live. It can either be an audio track, a MIDI track, a return...
Track.ViewRepresenting the view aspects of a track.
TuningSystemThis class represents a tuning system in Live.
WavetableDeviceThis class represents a Wavetable instrument. A WavetableDevice shares all of the ch...