Chain

This class represents a group device chain in Live.

Canonical Paths

live_set tracks N devices M chains L

live_set tracks N devices M return_chains L

live_set tracks N devices M chains L devices K chains P ...

live_set tracks N devices M return_chains L devices K chains P ...

Children

devices Device

Access: getobserve

mixer_device ChainMixerDevice

Access: get

Properties

color int

Access: getsetobserve

The RGB value of the chain's color in the form 0x00rrggbb or (2^16 * red) + (2^8) * green + blue, where red, green and blue are values from 0 (dark) to 255 (light).

When setting the RGB value, the nearest color from the color chooser is taken.

color_index long

Access: getsetobserve

The color index of the chain.

is_auto_colored bool

Access: getsetobserve

1 = the chain will always have the color of the containing track or chain.

has_audio_input bool

Access: get

has_audio_output bool

Access: get

has_midi_input bool

Access: get

has_midi_output bool

Access: get

mute bool

Access: getsetobserve

1 = muted (Chain Activator off)

muted_via_solo bool

Access: getobserve

1 = muted due to another chain being soloed.

name unicode

Access: getsetobserve

solo bool

Access: getsetobserve

1 = soloed (Solo switch on)
does not automatically turn Solo off in other chains.

Functions

delete_device

Parameter: index [int]
Delete the device at the given index.

insert_device

Parameters: device_name [symbol] target_index [int] (optional)

Attempts to insert the device specified by device_name at the given index in the chain. If no index is provided, attempts to insert the device at the end. Throws an error if insertion is not possible.
device_name is the name as it appears in the UI of Live.
Not all indices are valid. As can be expected, indices outside of the range defined by the current length of the device chain are invalid, but there are other limitations: for example, a MIDI effect can't be inserted after an instrument. The rule of thumb is that if an index would be invalid when inserting using the mouse, it's invalid here.

At the moment, only native Live devices can be inserted. Max for Live devices and plug-in are not supported.

Available since Live 12.3.