Track

Represents an audio, MIDI, return, or main track in a Live Set. The Track class hosts the track’s clip slots, devices, mixer, and routing — not all properties are supported by every track type, and individual members are marked accordingly.

Track

This class represents a track in Live. It can be either an Audio track, a MIDI Track, a Return Track or the Main track. The Main Track and at least one Audio or MIDI track will be always present. Return Tracks are optional. ^{From Live’s runtime docstring.}

Properties

Inherited from LomObject

_live_ptr: int

canonical_parent: Song

Get the canonical parent of the track. ^{From Live’s runtime docstring.}

arm: bool

Arm the track for recording. Not available for Main- and Send Tracks. ^{From Live’s runtime docstring.}

arrangement_clips: Vector[Clip]

const access to the list of clips in arrangement viewThe list will be empty for the main, send and group tracks. ^{From Live’s runtime docstring.}

available_input_routing_channels: RoutingChannelVector

Return a list of source channels for input routing. ^{From Live’s runtime docstring.}

available_input_routing_types: RoutingTypeVector

Return a list of source types for input routing. ^{From Live’s runtime docstring.}

available_output_routing_channels: RoutingChannelVector

Return a list of destination channels for output routing. ^{From Live’s runtime docstring.}

available_output_routing_types: RoutingTypeVector

Return a list of destination types for output routing. ^{From Live’s runtime docstring.}

back_to_arranger: bool

Indicates if it’s possible to go back to playing back the clips in the Arranger.Setting a value 0 will go back to the Arranger playback. Setting on grouptracks will go back to the Arranger on all grouped tracks. ^{From Live’s runtime docstring.}

can_be_armed: bool

return True, if this Track has a valid arm property. Not all tracks can be armed (for example return Tracks or the Main Tracks). ^{From Live’s runtime docstring.}

can_be_frozen: bool

return True, if this Track can be frozen. ^{From Live’s runtime docstring.}

can_show_chains: bool

return True, if this Track contains a rack instrument device that is capable of showing its chains in session view. ^{From Live’s runtime docstring.}

clip_slots: Vector[ClipSlot]

const access to the list of clipslots (see class AClipSlot) for this track. The list will be empty for the main and sendtracks. ^{From Live’s runtime docstring.}

color: int

Get/set access to the color of the Track (RGB). ^{From Live’s runtime docstring.}

color_index: int

Get/Set access to the color index of the track. Can be None for no color. ^{From Live’s runtime docstring.}

current_input_routing: str

Get/Set the name of the current active input routing. When setting a new routing, the new routing must be one of the available ones. ^{From Live’s runtime docstring.}

current_input_sub_routing: str

Get/Set the current active input sub routing. When setting a new routing, the new routing must be one of the available ones. ^{From Live’s runtime docstring.}

current_monitoring_state: int

Get/Set the track’s current monitoring state. ^{From Live’s runtime docstring.}

current_output_routing: str

Get/Set the current active output routing. When setting a new routing, the new routing must be one of the available ones. ^{From Live’s runtime docstring.}

current_output_sub_routing: str

Get/Set the current active output sub routing. When setting a new routing, the new routing must be one of the available ones. ^{From Live’s runtime docstring.}

devices: Vector[Device]

Return const access to all available Devices that are present in the Tracks Devicechain. This tuple will also include the ‘mixer_device’ that every Track always has. ^{From Live’s runtime docstring.}

fired_slot_index: int

const access to the index of the fired (and thus blinking) clipslot in this track. This index is -1 if no slot is fired and -2 if the track’s stop button has been fired. ^{From Live’s runtime docstring.}

fold_state: bool

Get/Set whether the track is folded or not. Only available if is_foldable is True. ^{From Live’s runtime docstring.}

group_track: Track

return the group track if is_grouped. ^{From Live’s runtime docstring.}

has_audio_input: bool

return True, if this Track can be feed with an Audio signal. This is true for all Audio Tracks. ^{From Live’s runtime docstring.}

has_audio_output: bool

return True, if this Track sends out an Audio signal. This is true for all Audio Tracks, and MIDI tracks with an Instrument. ^{From Live’s runtime docstring.}

has_midi_input: bool

return True, if this Track can be feed with an Audio signal. This is true for all MIDI Tracks. ^{From Live’s runtime docstring.}

has_midi_output: bool

return True, if this Track sends out MIDI events. This is true for all MIDI Tracks with no Instruments. ^{From Live’s runtime docstring.}

implicit_arm: bool

Arm the track for recording. When The track is implicitly armed, it showsin a weaker color in the live GUI and is not saved in the set. ^{From Live’s runtime docstring.}

input_meter_left: float

Momentary value of left input channel meter, 0.0 to 1.0. For Audio Tracks only. ^{From Live’s runtime docstring.}

input_meter_level: float

Return the MIDI or Audio meter value of the Tracks input, depending on the type of the Track input. Meter values (MIDI or Audio) are always scaled from 0.0 to 1.0. ^{From Live’s runtime docstring.}

input_meter_right: float

Momentary value of right input channel meter, 0.0 to 1.0. For Audio Tracks only. ^{From Live’s runtime docstring.}

input_routing_channel: RoutingChannel

Get and set the current source channel for input routing. Raises ValueError if the type isn’t one of the current values in available_input_routing_channels. ^{From Live’s runtime docstring.}

input_routing_type: RoutingType

Get and set the current source type for input routing. Raises ValueError if the type isn’t one of the current values in available_input_routing_types. ^{From Live’s runtime docstring.}

input_routings: StringVector

Const access to the list of available input routings. ^{From Live’s runtime docstring.}

input_sub_routings: StringVector

Return a list of all available input sub routings. ^{From Live’s runtime docstring.}

is_foldable: bool

return True if the track can be (un)folded to hide/reveal contained tracks. ^{From Live’s runtime docstring.}

is_frozen: bool

return True if this Track is currently frozen. No changes should be applied to the track’s devices or clips while it is frozen. ^{From Live’s runtime docstring.}

is_grouped: bool

return True if this Track is current part of a group track. ^{From Live’s runtime docstring.}

is_part_of_selection: bool

return False if the track is not selected. ^{From Live’s runtime docstring.}

is_showing_chains: bool

Get/Set whether a track with a rack device is showing its chains in session view. ^{From Live’s runtime docstring.}

is_visible: bool

return False if the track is hidden within a folded group track. ^{From Live’s runtime docstring.}

mixer_device: MixerDevice

Return access to the special Device that every Track has: This Device contains the Volume, Pan, Sendamounts, and Crossfade assignment parameters. ^{From Live’s runtime docstring.}

mute: bool

Mute/unmute the track. ^{From Live’s runtime docstring.}

muted_via_solo: bool

Returns true if the track is muted because another track is soloed. ^{From Live’s runtime docstring.}

name: str

Read/write access to the name of the Track, as visible in the track header. ^{From Live’s runtime docstring.}

output_meter_left: float

Momentary value of left output channel meter, 0.0 to 1.0. For tracks with audio output only. ^{From Live’s runtime docstring.}

output_meter_level: float

Return the MIDI or Audio meter value of the Track output (behind the mixer_device), depending on the type of the Track input, this can be a MIDI or Audio meter. Meter values (MIDI or Audio) are always scaled from 0.0 to 1.0. ^{From Live’s runtime docstring.}

output_meter_right: float

Momentary value of right output channel meter, 0.0 to 1.0. For tracks with audio output only. ^{From Live’s runtime docstring.}

output_routing_channel: RoutingChannel

Get and set the current destination channel for output routing. Raises ValueError if the channel isn’t one of the current values in available_output_routing_channels. ^{From Live’s runtime docstring.}

output_routing_type: RoutingType

Get and set the current destination type for output routing. Raises ValueError if the type isn’t one of the current values in available_output_routing_types. ^{From Live’s runtime docstring.}

output_routings: StringVector

Const access to the list of all available output routings. ^{From Live’s runtime docstring.}

output_sub_routings: StringVector

Return a list of all available output sub routings. ^{From Live’s runtime docstring.}

performance_impact: float

Reports the performance impact of this track. ^{From Live’s runtime docstring.}

playing_slot_index: int

const access to the index of the currently playing clip in the track. Will be -1 when no clip is playing. ^{From Live’s runtime docstring.}

solo: bool

Get/Set the solo status of the track. Note that this will not disable the solo state of any other track. If you want exclusive solo, you have to disable the solo state of the other Tracks manually. ^{From Live’s runtime docstring.}

take_lanes: Vector[TakeLane]

returns the take lanes. ^{From Live’s runtime docstring.}

view: View

Representing the view aspects of a Track. ^{From Live’s runtime docstring.}

Listener Only

data

add_data_listener · remove_data_listener · data_has_listener

Fires when the track’s underlying data store is modified — the generic state-change signal for the track’s persistent state. The programmatic trigger is set_data (read via get_data); whether other track-level mutations also fire it is unverified.

Methods

create_audio_clip()

Parameters

• file_path: str
• position: float

Returns

Clip

Creates an audio clip referencing the file at the given path and inserts it into the arrangement at the specified time. Throws an error when called on a non-audio or a frozen track, when the specified time is outside the [0., 1576800.] range, when the track is currently being recorded into, or when the path doesn’t point to a valid audio file. ^{From Live’s runtime docstring.}

create_midi_clip()

Parameters

• start_time: float
• length: float

Returns

Clip

Creates an empty MIDI clip and inserts it into the arrangement at the specified time. Throws an error when called on a non-MIDI track or a frozen track, when the specified time is outside the [0., 1576800.] range, or when the track is currently being recorded into. ^{From Live’s runtime docstring.}

create_take_lane()

Returns

TakeLaneProbed asLomObjecthigh confidence

• C++ signature returns TWeakPtr<TPyHandleBase> (generic LomObject) — no specific type enforced.
• docstring “Create a new TakeLane for this track” names the type.
• probe track.take_lanes element_repr is <class 'TakeLane.TakeLane'> — the runtime returns TakeLane instances when iterated, matching the create return.

Create a new TakeLane for this track. ^{From Live’s runtime docstring.}

delete_clip()

Parameters

• clip: Clip

Delete the given clip. Raises a runtime error when the clip belongs to another track. ^{From Live’s runtime docstring.}

delete_device()

Parameters

• index: int

Delete a device identified by the index in the ‘devices’ list. ^{From Live’s runtime docstring.}

duplicate_clip_slot()

Parameters

• index: int

Returns

int

Duplicate a clip and put it into the next free slot and return the index of the destination slot. A new scene is created if no free slot is available. If creating the new scene would exceed the limitations, a runtime error is raised. ^{From Live’s runtime docstring.}

duplicate_clip_to_arrangement()

Parameters

• clip: Clip
• destination_time: float

Returns

Clip

Duplicate the given clip into the arrangement of this track at the provided destination time and return it. When the type of the clip and the type of the track are incompatible, a runtime error is raised. ^{From Live’s runtime docstring.}

duplicate_device()

Parameters

• index: int

Duplicate a device at a given index in the ‘devices’ list. ^{From Live’s runtime docstring.}

get_data()

Parameters

• key: str
• default_value: AnyProbed asobjecthigh confidence
  • sister method same pattern as Song.get_data — corpus-confirmed.

Returns

AnyProbed asobjecthigh confidence

• sister method same pattern as Song.get_data — corpus-confirmed.

Get data for the given key, that was previously stored using set_data. ^{From Live’s runtime docstring.}

insert_device()

Parameters

• device_name: str
• device_index: int = -1

Returns

DeviceProbed asLomObjecthigh confidence

• sister method same shape as Chain.insert_device.
• C++ signature returns TWeakPtr<TPyHandleBase> (generic LomObject) — no specific type enforced.
• probe track.devices element_repr is <class 'Device.Device'> — the runtime returns Device instances when iterated, matching the insert return.
• docstring + [M4L] confirm semantics (“Add a device at a given index in the ‘devices’ list”).

Add a device at a given index in the ‘devices’ list. At end if -1. ^{From Live’s runtime docstring.}

jump_in_running_session_clip()

Parameters

• beats: float

Jump forward or backward in the currently running Sessionclip (if any) by the specified relative amount in beats. Does nothing if no Session Clip is currently running. ^{From Live’s runtime docstring.}

set_data()

Parameters

• key: str
• value: AnyProbed asobjecthigh confidence
  • sister method same pattern as Song.set_data — corpus-confirmed.

Store data for the given key in this object. The data is persistent and will be restored when loading the Live Set. ^{From Live’s runtime docstring.}

stop_all_clips()

Parameters

• quantized: bool = True

Stop running and triggered clip and slots on this track. ^{From Live’s runtime docstring.}

Nested types

• Track.View — Representing the view aspects of a Track.
• Track.monitoring_states

Returned by 9 members elsewhere in the LOM

Song

• create_audio_track() → Track
• create_midi_track() → Track
• create_return_track() → Track
• master_track: Track
• return_tracks: Vector[Track]
• tracks: Vector[Track]
• visible_tracks: Vector[Track]

Song.View

• selected_track: Track

RoutingType

• attached_object: Track

Other classes

DeviceContainer

Phantom base in the LOM type system. Track and Chain both register DeviceContainer as their direct Python superclass via Boost.Python’s bases<> mechanism — Track.__mro__ includes it, isinstance(track, DeviceContainer) is True — but Boost binds the shared methods and properties on each concrete subclass rather than on the base. Result: real Python inheritance, structurally empty class.

Members are redefined on each subclass. The shared surface (color, color_index, mute, muted_via_solo, name, solo, delete_device, duplicate_device, insert_device) is declared independently on Track and Chain, each carrying its own runtime docstring. The declarations live on the subclasses; this class is the structural parent that holds them together for isinstance purposes only.

Idiomatic code ignores it. Ableton’s own corpus and the M4L docs contain zero references to DeviceContainer — the convention is isinstance(c, (Live.Track.Track, Live.Chain.Chain)) rather than testing against the common base. Treat it as an implementation detail of the LOM type system, not a class to program against. ^{Runtime docstringThis class is a common super class of Track and Chain}

Properties

Inherited from LomObject

_live_ptr: int

canonical_parent: LomObject | None

Get the canonical parent — the structural owner one step up the LOM tree. ^{From Live’s runtime docstring.}

RoutingChannel

This class represents a routing channel. ^{From Live’s runtime docstring.}

Properties

display_name: str

Display name of routing channel. ^{From Live’s runtime docstring.}

layout: RoutingChannelLayout

The routing channel’s Layout, e.g., mono or stereo. ^{From Live’s runtime docstring.}

Returned by 4 members elsewhere in the LOM

CompressorDevice

• input_routing_channel: RoutingChannel

DeviceIO

• routing_channel: RoutingChannel

Track

• input_routing_channel: RoutingChannel
• output_routing_channel: RoutingChannel

RoutingChannelVector

A container for returning routing channels from Live. ^{From Live’s runtime docstring.}

Methods

append()

Parameters

• value: RoutingChannel

extend()

Parameters

• values: Iterable[RoutingChannel]

Returned by 4 members elsewhere in the LOM

CompressorDevice

• available_input_routing_channels: RoutingChannelVector

DeviceIO

• available_routing_channels: RoutingChannelVector

Track

• available_input_routing_channels: RoutingChannelVector
• available_output_routing_channels: RoutingChannelVector

RoutingType

This class represents a routing type. ^{From Live’s runtime docstring.}

Properties

attached_object: Track

Live object associated with the routing type. ^{From Live’s runtime docstring.}

category: RoutingTypeCategoryProbed asinthigh confidence

• sister method RoutingTypeCategory enum in same module (Track). Property is a member of RoutingType and names a category of routing — direct semantic match.

Category of the routing type. ^{From Live’s runtime docstring.}

display_name: str

Display name of routing type. ^{From Live’s runtime docstring.}

Returned by 4 members elsewhere in the LOM

CompressorDevice

• input_routing_type: RoutingType

DeviceIO

• routing_type: RoutingType

Track

• input_routing_type: RoutingType
• output_routing_type: RoutingType

RoutingTypeVector

A container for returning routing types from Live. ^{From Live’s runtime docstring.}

Methods

append()

Parameters

• value: RoutingType

extend()

Parameters

• values: Iterable[RoutingType]

Returned by 4 members elsewhere in the LOM

CompressorDevice

• available_input_routing_types: RoutingTypeVector

DeviceIO

• available_routing_types: RoutingTypeVector

Track

• available_input_routing_types: RoutingTypeVector
• available_output_routing_types: RoutingTypeVector

Track.View

Representing the view aspects of a Track. ^{From Live’s runtime docstring.}

Properties

Inherited from LomObject

_live_ptr: int

canonical_parent: Track

Get the canonical parent of the track view. ^{From Live’s runtime docstring.}

device_insert_mode: bool

Get/Listen the device insertion mode of the track. By default, it will insert devices at the end, but it can be changed to make it relative to current selection. ^{From Live’s runtime docstring.}

is_collapsed: bool

Get/Set/Listen if the track is shown collapsed in the arranger view. ^{From Live’s runtime docstring.}

selected_device: Device

Get/Set/Listen the insertion mode of the device. While in insertion mode, loading new devices from the browser will place devices at the selected position. ^{From Live’s runtime docstring.}

Methods

select_instrument()

Returns

bool

Selects the track’s instrument if it has one. ^{From Live’s runtime docstring.}

Returned by 1 member elsewhere in the LOM

Track

• view: View

Enums

DeviceInsertMode

Members

default	0
selected_left	1
selected_right	2
count	3

RoutingChannelLayout

Members

mono	1
stereo	2
midi	0

RoutingTypeCategory

Members

external	0
rewire	1
resampling	2
master	3
track	4
parent_group_track	5
none	6
invalid	7

Track.monitoring_states

Members

IN	0
AUTO	1
OFF	2