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 read-onlyobserve
mixer_device ChainMixerDevice read-only
Properties
color int observe
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 observe
The color index of the chain.
is_auto_colored bool observe
1 = the chain will always have the color of the containing track or chain.
has_audio_input bool read-only
has_audio_output bool read-only
has_midi_input bool read-only
has_midi_output bool read-only
mute bool observe
1 = muted (Chain Activator off)
muted_via_solo bool read-onlyobserve
1 = muted due to another chain being soloed.
name unicode observe
solo bool observe
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.