mixer_set_track
Destructive
Change one FL Studio mixer track's name, color, volume, pan, stereo separation, mute, solo, record arm, EQ bands, sends, or active selection in one write-mode call.
Instructions
Change any combination of one mixer track's settings in one call.
Set only the fields to change: name, color, volume (normalized or dB), pan,
stereo separation, mute, solo, record arm, built-in EQ bands, sends, and
whether it is the active track. Requires write mode
(session_set_write_mode). Writes run in that order, each read back on a
later FL tick with its own receipt; verified is true only when every write
verified. Non-atomic: earlier writes remain if a later one fails, and an
unknown outcome stops the rest. Use plugin_set_parameter for effect
parameters and project_apply_edits for several tracks. Does not save.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eq | No | Built-in three-band EQ changes, one entry per band. | |
| pan | No | Pan from -1 hard left through 0 centre to 1 hard right. | |
| name | No | Track name; "" restores FL's default name. | |
| armed | No | Absolute recording-arm state. | |
| color | No | FL color word, unsigned 0xAABBGGRR; FL may change the high byte. | |
| muted | No | Absolute mute state. | |
| sends | No | Sends to other tracks: create or remove a route with enabled, set its amount with level_normalized. | |
| select | No | Also make this the active (selected) mixer track, after the other changes. | |
| soloed | No | Absolute solo state. | |
| volume_db | No | Fader target in dB; found by searching FL's fader curve, which moves the fader while it searches. | |
| track_index | Yes | Zero-based mixer index. Index 0 is Master and needs allow_master=true. | |
| allow_master | No | Deliberately target Master at index 0. | |
| tolerance_db | No | Maximum dB readback error; defaults to 0.1. Only with volume_db. | |
| expected_before | No | Optional current values from mixer_get_track for the fields this call changes; refuse if any changed. Guards for unchanged fields are refused. | |
| stereo_separation | No | FL stereo separation from -1 to 1. | |
| volume_normalized | No | Fader position 0..1; 0.8 is 0 dB. Use volume_db for decibels. | |
| stop_on_unverified | No | Skip the remaining writes after the first write whose readback did not verify. An unknown outcome always stops the sequence. | |
| session_fingerprint | No | Optional session_fingerprint from a recent read. The call refuses after a bridge reload or a reported project load. This is a concurrency guard, not authentication or a durable project identity. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes | ||
| verified | Yes | ||
| warnings | No | ||
| completed | Yes | ||
| applied_at | Yes | ||
| track_index | Yes | ||
| project_saved | No | ||
| skipped_count | Yes | ||
| skipped_steps | No | ||
| schema_version | No | 1.0 | |
| stopped_reason | No | ||
| attempted_count | Yes | ||
| requested_count | Yes | ||
| rollback_attempted | No | ||
| stop_on_unverified | Yes | ||
| session_fingerprint | Yes | ||
| automatic_replay_attempted | No | ||
| one_session_preflight_completed | No |