set_mix
Idempotent
Adjust volume, pan, sends, mute, and solo on a single track in one request. Set absolute mixer values with optional parameters for quick, focused mixing changes.
Instructions
Set volume, pan, sends, mute and solo on one track in a single round trip.
Every argument is optional and only the ones given are written, so this is the
cheap way to change several mixer controls at once. Read the current state with
get_track first, since the values here are absolute and not relative.
Returns:
Dictionary reporting each write with its before and after value, and the dB
display where Live offered one.
Note:
Volume and pan are normalised, so 0.85 is 0 dB (measured) rather than 85 per
cent of anything. Read ``display`` in the answer for Live's own dB reading
instead of converting the normalised number yourself.
The master track has no mute and no solo. Both are refused there rather than
silently ignored, and ``track`` is not read at all when kind is master.
This is the mixer only. For a knob on a device in the chain use
set_parameter, and for the tempo use set_tempo. To make a mixer control move
over time rather than jump, write an envelope with write_automation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pan | No | Pan position from -1.0 hard left through 0.0 centre to 1.0 hard right. Omit to leave it alone. | |
| kind | No | Which collection the track index counts in: 'track' for song.tracks, 'return' for song.return_tracks, 'master' for the master track, where the track index is ignored. | track |
| mute | No | True mutes the track, False unmutes it. Not supported on the master track. Omit to leave it alone. | |
| solo | No | True solos the track, which silences the others rather than changing anything on this one. Not supported on the master track. Omit to leave it alone. | |
| sends | No | Send levels to write, keyed by send letter as Live labels it ('A', 'B') or by index as a string ('0', '1'), with normalised values 0.0 to 1.0. Only the sends named are written. Omit to leave every send alone. | |
| track | Yes | Track index in song.tracks, counted from 0. | |
| volume | No | Fader position, normalised 0.0 to 1.0, not decibels. 0.85 is 0 dB (measured) and the scale between is not linear, so 0.425 is not half the level. Omit to leave the fader alone. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||