User Tools

Site Tools


mixxxcontrols

Mixxx Controls

What is a control?

Nearly every knob, button, or fader you see in Mixxx's interface is controllable via Mixxx's “control” system. The control system allows skins, MIDI controllers, and HID controllers to control Mixxx via a single interface.

A control is identified by a “group” (which is used for grouping associated controls) and a “key” (the name of the individual control).

For example, the volume fader for Deck 1 is identified by the group [Channel1] and key volume. Similarly, the volume fader for Sampler 1 is identified by the group [Sampler1] and key volume.

The group is used to collect all the controls that affect one component of Mixxx into one collection. Some groups have a high overlap of controls in common (e.g. samplers, decks, and the preview deck all share the same control keys).

In addition to controlling Mixxx, the control system can be used to inspect Mixxx's state. For example, the sample rate of the track loaded in Deck 1 can be accessed via the [Channel1], track_samplerate control. You can read the [Channel3], play control to determine whether Deck 3 is playing.

The following tables list the keys associated with each group.

Tip: Discovering Controls used in Skins

You can view the control connected to any part of a skin by running Mixxx with the --developer command line option and hovering your mouse cursor over part of the skin. If no tooltip appears, enable tooltips for the Library and Skin in Options > Preferences > Interface.

Tip: Changing any control from the GUI in Developer Mode

When running Mixxx in Developer Mode (with the --developer command line option), you can view and manually set the state of any control in Mixxx by going to Developer > Developer Tools.

List of Controls

The default range is 0.0 to 1.0, unless otherwise noted. Binary means that it is either 'ON' (non-zero) or 'OFF' (zero).

Please keep the controls in alphabetical order within each group.

[Various]

The following extensions add some features to ControlPotMeter controls (volume, crossfader, …). Use in conjunction with [ChannelN], [SamplerN], [Master] … groups

Key/ControlRangeWhat it doesOn-screen feedback
_updefaultIncreases the valuee.g. “[ChannelN],rate_perm_up” sets the speed one step higher (4 % default)
_downdefaultDecreases the valuee.g. “[ChannelN],rate_perm_down” sets the speed one step lower (4 % default)
_up_smalldefaultIncreases the value by smaller stepe.g. “[ChannelN],rate_perm_up_small” sets the speed one small step higher (1 % default)
_down_smalldefaultDecreases the value by smaller stepe.g. “[ChannelN],rate_perm_down_small” sets the speed one small step lower (1 % default)
_set_one1)defaultSets the value to 1.0e.g. “[ChannelN],volume_set_one” sets the channel volume to full
_set_minus_one2)defaultSets the value to -1.0e.g. “[ChannelN],volume_set_minus_one” sets the channel volume to zero
_set_default3)defaultSets the control to its defaulte.g. “[ChannelN],waveform_zoom_set_default” return to default waveform zoom level
_set_zero4)defaultSets the value to 0.0e.g. “[Master],crossfader_zero” put the crossfader in the middle again
_toggle5)defaultSets the value to 0.0 if the value was > 0.0, and to 1.0 if the value was 0.0e.g. “[ChannelN],volume_toggle” will cut off/on a track while you're playing
_minus_toggle6)defaultSets the value to -1.0 if the value was > -1.0, and to 1.0 if the value was -1.0e.g. “[Master],crossfader_minus_toggle” can tilt the crossfader from left to right

[Master]

The [Master] group generally corresponds to controls that affect the mixing engine. This will bear some similarity to what you will find on a DJ mixer (e.g. crossfader controls, headphone cueing controls, etc.).

Key/Control Range What it does On-screen feedback
audio_latency_usage7) 0 .. 25 % Reflects fraction of latency, given by the audio buffer size, spend for audio processing inside Mixxx. At value near 25 % there is a high risk of buffer underflows latency meter
audio_latency_overload8) binary Indicates a buffer under or over-flow. Resets after 500 ms Overload indicator
audio_latency_overload_count9) 0 .. n Counts buffer over and under-flows. Max one per 500 ms Counter in hardware preferences
balance -1.0..1.0 Adjusts the left/right channel balance on the Master output Center Balance knob
crossfader -1.0..1.0 Adjusts the crossfader between players/decks (-1.0 is all the way left, Deck 1) Crossfader slider
crossfader_down binary Moves the crossfader left by 1/10th Crossfader slider
crossfader_down_small10) binary Moves the crossfader left by 1/100th Crossfader slider
crossfader_up binary Moves the crossfader right by 1/10th Crossfader slider
crossfader_up_small11) binary Moves the crossfader right by 1/100th Crossfader slider
duckStrength12) 0.0..1.0 Microphone ducking strength Strength knob
enabled13) binary Indicator that the master mix is processed n/a
gain14) 0.0..1.0..5.0 Adjusts the Master output gain Master Vol knob
headEnabled15) binary Indicator that the headphone mix is processed n/a
headGain16) 0.0..1.0..5.0 Adjusts the headphone output gain Head Vol knob
headMix -1.0..1.0 Adjusts the cue/main mix in the headphone output Pre/Main knob
headSplit17) binary Splits headphone cueing into right = master mono and left = pfl mono. Split Cue button
latency absolute value Latency setting (sound buffer size) in milliseconds (default 64) Latency slider in the prefs
maximize_library18) binary Toggle maximized view of library Toggle maximized view of library
num_decks19) integer The number of decks currently enabled. N/A
num_effectsavailable20) integer (read only) The number of available effects that can be selected in an effect slot. N/A
num_samplers21) integer The number of samplers currently enabled. N/A
num_preview_decks22) integer The number of preview decks currently enabled. N/A
PeakIndicator binary Indicates when the signal is clipping (too loud for the hardware and is being distorted) Clip light
samplerate absolute value The current output sample rate in Hz (default 44100) (none)
talkoverDucking23) FIXME Toggle microphone ducking mode (OFF, AUTO, MANUAL) Ducking mode button
VuMeter default Outputs the current instantaneous master volume (composite) Master meter (mono)
VuMeterL default Outputs the current instantaneous master volume for the left channel Master meter L
VuMeterR default Outputs the current instantaneous master volume for the right channel Master meter R

[ChannelN]

The [ChannelN] group is for each deck in Mixxx. Whenever you see [ChannelN], think “Deck N”. N can range from 1 to the number of active decks in Mixxx.24)

Key/Control Range What it does On-screen feedback
back binary Fast rewind (REW) < button
beat_active25) binary Indicates whether the player is currently positioned within 50 milliseconds of a beat or not. N/A
beatjump26) real number Jump forward by X beats (positive) or backward by X beats (negative). Player jumps forward or backward by X beats.
beatjump_size27) positive real number Set the number of beats to jump with beatjump_forward/backward. Beatjump size spinbox
beatjump_forward28) binary Jump forward by beatjump_size Player jumps forward by beatjump_size.
beatjump_backward29) binary Jump backward by beatjump_size Player jumps backward by beatjump_size.
beatjump_X_forward30) binary Jump forward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 Player jumps forward by X beats.
beatjump_X_backward31) binary Jump backward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 Player jumps backward by X beats.
beatloop_X_activate32) binary Activates a loop over X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 A loop is shown over X beats.
beatloop_size33) positive real number Set the length of the loop in beats that will get set with beatloop_toggle and beatlooproll_activate. Changing this will resize an existing loop if the length of the loop matches beatloop_size. Beatloop size spinbox and possibly loop section on waveform
beatloop_size_halve34) binary Halve beatloop_size. This will resize an existing loop if the length of the loop matches beatloop_size. Beatloop size spinbox and possibly loop section on waveform
beatloop_size_double35) binary Double beatloop_size. This will resize an existing loop if the length of the loop matches beatloop_size. Beatloop size spinbox and possibly loop section on waveform
beatloop_toggle36) binary Set a loop that is beatloop_size beats long A loop is shown over beatloop_size beats
beatloop_X_toggle37) binary Toggles a loop over X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 A loop is shown over X beats.
beatloop_X_enabled38) binary 1 if beatloop X is enabled, 0 if not. Beatloop X button in skin is lit.
beatlooproll_activate39) binary Activates a rolling loop over beatloop_size beats. Once disabled, playback will resume where the track would have been if it had not entered the loop. A loop overlay is shown over beatloop_size beats on waveform.
beatlooproll_X_activate40) binary Activates a rolling loop over X beats. Once disabled, playback will resume where the track would have been if it had not entered the loop. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 Beatloop X button in skin is lit. A loop overlay is shown over X beats on waveform.
beats_adjust_faster41) binary Adjust the average BPM up by +0.01 Beatgrid lines move closer to each other.
beats_adjust_slower42) binary Adjust the average BPM down by -0.01. Beatgrid lines move further apart from each other.
beats_translate_curpos43) binary Adjust beatgrid so closest beat is aligned with the current playposition. Beatgrid moves to align with current playposition.
beats_translate_match_alignment44) binary Adjust beatgrid to match another playing deck. Instead of syncing the beatgrid to the current playposition, sync the beatgrid so the nearest beat lines up with the other track's nearest beat.
beats_translate_earlier45) binary Move Beatgrid earlier Beatgrid moves left by a small amount.
beats_translate_later46) binary Move Beatgrid later Beatgrid moves right by a small amount.
beatsync binary Syncs the BPM to that of the other track (if BPM is detected on both) SYNC button & Speed slider snaps to the appropriate value
beatsync47) binary changed behavior Syncs the BPM and phase to that of the other track (if BPM is detected on both) SYNC button & Speed slider snaps to the appropriate value
beatsync_phase48) binary Syncs the phase to that of the other track (if BPM is detected on both) SYNC button & Speed slider snaps to the appropriate value
beatsync_tempo49) binary Syncs the BPM to that of the other track (if BPM is detected on both) SYNC button & Speed slider snaps to the appropriate value
bpm absolute value Reads or sets the track's current BPM (changing the pitch) BPM value display
bpm50) real-valued bpm now only reflects the bpm of the loaded track N/A
bpm51) real-valued bpm reflects the perceived (rate-adjusted) BPM of the file loaded in ChannelN BPM value display
bpm_tap52) binary When tapped repeatedly, adjusts the playback rate of ChannelN to match the tapped BPM track playback rate shifts after 4 or more taps
bpm_tap53) binary When tapped repeatedly, adjusts the BPM of ChannelN to match the tapped BPM BPM value display (play speed doesn't change)
cue_default binary In CDJ mode, when playing, returns to the cue point & pauses. If stopped, sets a cue point at the current location. If stopped and at a cue point, plays from that point until released (set to 0.) CUE button
cue_gotoandplay54) binary If the Cue point is set, seeks the player to it and starts playback. Player may change position and start playing.
cue_gotoandstop55) binary If the Cue point is set, seeks the player to it and stops. Player may change position.
cue_indicator56) binary Provides information to be bound to the Cue Button e.g. blinking when next press will move the cue point Cue button
cue_cdj57) binary Cue button, always in CDJ mode n/a
cue_play58) binary CUP button, Go to cue point and play after release. If stopped, sets a cue point at the current location. n/a
cue_point absolute value The current position of the cue point in samples Cue point marker
cue_preview binary Plays from the current cue point CUE button lights & waveform moves
cue_set binary Sets a cue point at the current location Cue mark appears on the waveform
cue_simple binary If the player is not playing, set the cue point at the current location otherwise seek to the cue point. CUE button
duration absolute value Outputs the length of the current song in seconds (none)
eject59) binary Eject currently loaded track Eject button is lit. Be sure to set back to 0 with scripts so the button does not stay lit.
end binary Jump to end of track Track jumps to end
file_bpm positive value (Read-only) the detected BPM of the loaded track N/A
file_key60) ? (Read-only) the detected key of the loaded track N/A
fwd binary Fast forward (FF) > button
hotcue_X_activate61) binary If hotcue X is set, seeks the player to hotcue X's position. If hotcue X is not set, sets hotcue X to the current play position. To continue playing while any hotcues are activated, play must be set to 0, not 1. Player may change position. Hotcue X marker may change on waveform.
hotcue_X_clear62) binary If hotcue X is set, clears its hotcue status. Hotcue X marker changes on waveform.
hotcue_X_enabled63) read-only, binary 1 if hotcue X is active, (position is not -1), 0 otherwise.
hotcue_X_goto64) binary If hotcue X is set, seeks the player to hotcue X's position. Player may change position.
hotcue_X_gotoandplay65) binary If hotcue X is set, seeks the player to hotcue X's position and starts playback. Player may change position.
hotcue_X_gotoandstop66) binary If hotcue X is set, seeks the player to hotcue X's position and stops. Player may change position.
hotcue_X_position67) positive integer The position of hotcue X in samples, -1 if not set. Hotcue X marker changes on waveform.
hotcue_X_set68) binary Set hotcue X to the current play position. If hotcue X was previously set, clears its hotcue status. Hotcue X marker changes on waveform.
key69) real-valued Current key of the track
keylock70) binary Enable key-lock for the specified deck (rate changes only affect tempo, not key) key-lock button activates
LoadSelectedTrack binary Loads the currently highlighted track into the deck Track name & waveform change
LoadSelectedTrackAndPlay71) binary Loads the currently highlighted track into the deck and starts playing Track name & waveform change & Play/pause button
loop_double72) binary Doubles the current loop's length by moving the end marker. Doubles beatloop_size if the current loop matches beatloop_size or there is no loop set. Do not map this to controllers to select beatloop_size because it will not work if the loop is out of sync with beatloop_size. Use beatloop_double instead. Loop length doubles on waveform
loop_enabled73) read-only, binary Indicates whether or not a loop is enabled. Read-only, do not set. Loop in waveform is active.
loop_end_position74) positive integer The player loop-out position in samples, -1 if not set. Loop-out marker shows on waveform.
loop_halve75) binary Halves the current loop's length by moving the end marker. Player immediately loops if past the new endpoint. Halves beatloop_size if the current loop matches beatloop_size or there is no loop set. Do not map this to controllers to select beatloop_size because it will not work if the loop is out of sync with beatloop_size. Use beatloop_halve instead. Loop length halves on waveform
loop_in76) binary If loop is disabled, sets the player loop in position to the current play position. If loop is enabled, press and hold to move loop in position to the current play position. 77) Loop-in marker changes on waveform.
loop_out78) binary If loop is disabled, sets the player loop out position to the current play position. If loop is enabled, press and hold to move loop out position to the current play position. 79) Loop-out marker changes on waveform.
loop_move80) real number Move loop forward by X beats (positive) or backward by X beats (negative). Loop moves forward or backward by X beats.
loop_move_forward81) binary Move loop forward by 1 beat. If the beatloop_size is less than 1 beat, move the loop forward by beatloop_size beats. Loop moves forward
loop_move_forward_beatloop_size82) binary Move loop forward by beatloop_size beats. Loop moves forward
loop_move_X_forward83) binary Moves the loop in and out points forward by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 Loop moves forward by X beats.
loop_move_backward84) binary Move loop backward by 1 beat. If the beatloop_size is less than 1 beat, move the loop backward by beatloop_size beats. Loop moves backward
loop_move_backward_beatloop_size85) binary Move loop backward by beatloop_size beats. Loop moves backward
loop_move_X_backward86) binary Loop moves by X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 Loop moves backward by X beats.
loop_scale87) 0.0 - infinity Scale the loop length by the value scale is set to by moving the end marker. Loop length is scaled by given amount on waveform.
loop_start_position88) positive integer The player loop-in position in samples, -1 if not set. Loop-in marker changes on waveform.
orientation89) 0-2 Crossfader assignment. 0 = left side of crossfader, 1 = center (not affected by crossfader), 2 = right side of crossfader N/A
passthrough90) binary Connects the vinyl control input for vinyl control on that deck to the channel output. Allows to mix external media into DJ sets. GUI control currently missing FIXME
PeakIndicator binary Indicates when the signal is clipping (too loud for the hardware and is being distorted) Clip light
pfl binary Toggles headphone cueing Headphone button
pitch91) -6.0..6.0 Changes the track pitch independent of the tempo. Key display
pitch_adjust92) -3.0..3.0 Adjust the pitch in addition to the speed slider pitch. Key display
play binary Toggles playing or pausing the track. Feedback: 1.0 if track is playing or play command is adopted and track will be played after loading Play/pause button
play_indicator93) binary Provides information to be bound with the a Play/Pause button e.g blinking when play is possible Play/pause button
play_stutter94) binary A play button without pause. Pushing while playing, starts play at cue point again (Stutter). Play/Stutter button
playposition default Sets the absolute position in the track. The Range is -0.14 to 1.14 (0 = beginning → Midi 14, 1 = end → Midi 114) Waveform
pregain 0.0..1.0..4.0 Adjusts the pre-fader gain of the track (to avoid clipping) GAIN knob
quantize95) binary Aligns Hot-cues and Loop In & Out to the next beat from the current position. Hot-cues or Loop In/Out markers
quantize_beat96) deprecated ? Is used internally by CueControl (CUEs & Hotcues) and LoopingControl for quantization.
rate -1.0..1.0 Speed control Speed slider
rate_dir -1 or 1 indicates orientation of speed slider. ?
rate_perm_down binary Sets the speed one step lower (4 % default) lower Perm down button & Speed slider
rate_perm_down_small binary Sets the speed one small step lower (1 % default) Perm down button & Speed slider
rate_perm_up binary Sets the speed one step higher (4 % default) Perm up button & Speed slider
rate_perm_up_small binary Sets the speed one small step higher (1 % default) Perm up button & Speed slider
rate_temp_down binary Holds the speed one step lower while active Temp down button & Speed slider
rate_temp_down_small binary Holds the speed one small step lower while active Temp down button & Speed slider
rate_temp_up binary Holds the speed one step higher while active Temp up button & Speed slider
rate_temp_up_small binary Holds the speed one small step higher while active Temp up button & Speed slider
rateRange 0.0..3.0 Sets the range of the Speed slider (0.08 = 8%) none, until you move the Speed slider
rateEngine Actual rate (used in visuals, not for control)
reloop_andstop97) binary Activate current loop, jump to its loop in point, and stop playback. Loop range in waveform activates or deactivates and play position moves to loop in point.
reloop_toggle98) binary Toggles the current loop on or off. If the loop is ahead of the current play position, the track will keep playing normally until it reaches the loop. Loop range in waveform activates or deactivates.
repeat99) binary Enable repeat-mode for the specified deck when track finishes, song loops to beginning
reset_key100) binary Resets the key to the original track key.
reverse binary Toggles playing the track backwards REV button
reverseroll101) binary Enables reverse and slip mode while held (Censor) REV button
scratch2102) -3.0..3.0 Affects absolute play speed & direction whether currently playing or not when scratch2_enabled is active. (multiplicative). Use JavaScript engine.scratch functions to manipulate in controller mappings. Waveform
scratch2_enable103) binary Takes over play speed & direction for scratch2. Waveform
slip_enabled104) binary Toggles slip mode. When active, the playback continues muted in the background during a loop, scratch etc. Once disabled, the audible playback will resume where the track would have been. Slip mode button
start binary Jump to start of track Track jumps to start
start_play105) binary Start playback from the beginning of the deck. Deck plays from beginning
start_stop106) binary Seeks a player to the start and then stops it. Deck stops at the beginning
stop107) binary Stops a player. Pause Button. Deck pauses at the current position
sync_enabled108) binary Syncs the BPM and phase to that of the other track (if BPM is detected on both). Click & hold for at least one second activates Master sync on that deck. SYNC button & Speed slider snaps to the appropriate value
sync_master109) binary Sets deck as master clock
sync_mode110) binary SYNC_NONE = 0; SYNC_FOLLOWER = 1; SYNC_MASTER = 2,
sync_key111) ? Match musical key Key value widget
track_loaded112) binary (Read-only) Whether a track is loaded in the specified deck Waveform and track metadata shown in deck
track_samplerate113) absolute value (Read-only) Sample rate of the track loaded on the specified deck n/a
track_samples absolute value (Read-only) Number of sound samples in the track loaded on the specified deck n/a
volume default Adjusts the channel volume fader VOL fader
mute114) binary Mutes the channel Mute button
vinylcontrol_enabled115) binary Toggles whether a deck is being controlled by digital vinyl When enabled, a vinyl indication should appear onscreen indicating green for Enabled
vinylcontrol_cueing116) 0.0-2.0 Determines how cue points are treated in vinyl control Relative mode Off - cue points ignored; One Cue - If needle is dropped after the cue point, track will seek to that cue point; hot cue - track will seek to nearest previous hot cue point
vinylcontrol_mode117) 0.0-2.0 Determines how vinyl control interprets needle information: absolute mode - track position equals needle position and speed; relative mode - track speed equals needle speed regardless of needle position; constant mode - track speed equals last known-steady speed regardless of needle input 3-way button indicates status
vinylcontrol_status118) 0.0-3.0 (read-only) Provides visual feedback with regards to vinyl control status Off for control disabled, green for control enabled, blinking yellow for when the needle reaches the end of the record, and red for needle skip detected
visual_bpm119) ? BPM to display in the UI (updated more slowly than the actual bpm) BPM value widget
visual_key120) ? Current musical key after pitch shifting to display in the UI using the notation selected in the preferences Key value widget
visual_key_distance121) -0.5..0.5 The distance to the nearest key measured in cents Key value widget
VuMeter default Outputs the current instantaneous deck volume Deck VU meter
VuMeterL default Outputs the current instantaneous deck volume for the left channel Deck VU meter L
VuMeterR default Outputs the current instantaneous deck volume for the right channel Deck VU meter R
waveform_zoom122) 1.0 - 6.0 Zooms the waveform to look ahead or back as needed. Waveform zoom buttons
waveform_zoom_up123) ? Waveform Zoom Out Waveform zoom buttons
waveform_zoom_down124) ? Waveform Zoom In Waveform zoom buttons
waveform_zoom_set_default125) ? Return to default waveform zoom level Waveform zoom buttons
wheel -3.0..3.0 Affects relative play speed & direction persistently (additive offset & must manually be undone) Waveform

[SamplerN]

Sample decks (“samplers”) in Mixxx are identical to decks, they simply have a different purpose (playing samples). Any control listed above for [ChannelN] will work for a sampler, just replace [ChannelN] with [SamplerN].

Key/ControlRangeWhat it doesOn-screen feedback
[Sampler],SaveSamplerBank126)binarySave sampler configuration. Make currently loaded tracks in samplers instantly available at a later point.Opens file dialog. Configuration file can be named and saved.
[Sampler],LoadSamplerBank127)binaryLoad saved sampler configuration file and add tracks to the available samplers.Opens file dialog. Select configuration file.

[PreviewDeckN]

Preview decks in Mixxx are identical to regular decks. Any control listed above for [ChannelN] will work for a preview deck, just replace [ChannelN] with [PreviewDeckN].

[VinylControl]

Key/ControlRangeWhat it doesOn-screen feedback
Toggle128)binaryMoves control by a vinyl control signal from one deck to another if using the single deck vinyl control (VC) feature.If VC isn't enabled on any decks, enable it on the first one we're receiving samples for. If VC is enabled on a single (exclusive) deck, and another deck is setup to receive samples, disable it on the former deck and enable it on the next eligible deck (ordered by deck number). If VC is enabled on multiple decks, don't do anything.

[MicrophoneN]

Below, N=2 up to the number of active microphones. e.g [Microphone2], for Mic #1 just use [Microphone]129).

Key/ControlRangeWhat it doesOn-screen feedback
enabled130)binary1 if a microphone input is enabled, 0 if not.Microphone is enabled.
orientation131)0-2Set microphone orientation, 0 = left side of crossfader, 1 = center, 2 = right side of crossfader. Default is center.N/A
PeakIndicator132)binaryIndicates when the signal is clipping (too loud for the hardware and is being distorted)Microphone Clip light
talkover133)binaryHold value at 1 to mix microphone input into the master output.Talk button
volume134)defaultAdjusts the microphone volume faderMicrophone volume fader changes
pregain0.0..1.0..4.0Adjusts the gain of the mic input Microphone gain knob
mute135)binaryMutes the channelMute button
VuMeter136)defaultOutputs the current instantaneous microphone volumeMicrophone VU meter changes

[Recording]

Key/ControlRangeWhat it doesOn-screen feedback
toggle_recordingbinaryTurns recording on or off.Recording icon
statusbinaryIndicates whether Mixxx is currently recording.Recording icon

[AutoDJ]

Key/ControlRangeWhat it doesOn-screen feedback
enabled137)binaryTurns Auto DJ on or off.AutoDJ button
shuffle_playlist138)binaryShuffles the content of the Auto DJ playlist.Order of tracks in the AutoDJ playlist changes.
skip_next139)binarySkips the next track in the Auto DJ playlist.Skipped track is removed from the AutoDJ playlist.
fade_now140)binaryTriggers the transition to the next track.Crossfader slider moves to the other side.

[Library]

Key/Control Range What it does On-screen feedback
MoveUp141) Binary Equivalent to pressing the UP key on the keyboard Currently selected item changes
MoveDown142) Binary Equivalent to pressing the DOWN key on the keyboard Currently selected item changes
MoveVertical143) Relative Move UP or DOWN the specified number of locations (negative for UP). Intended to be mapped to an encoder knob. Currently selected item changes
ScrollUp144) Binary Equivalent to pressing the PAGEUP key on the keyboard Currently selected item changes
ScrollDown145) Binary Equivalent to pressing the PAGEDOWN key on the keyboard Currently selected item changes
ScrollVertical146) Relative Scroll UP or DOWN the specified number of pages (negative for UP). Intended to be mapped to an encoder knob. Currently selected item changes
MoveLeft147) Binary Equivalent to pressing the LEFT key on the keyboard Currently selected item changes
MoveRight148) Binary Equivalent to pressing the RIGHT key on the keyboard Currently selected item changes
MoveHorizontal149) Relative Move LEFT or RIGHT the specified number of locations (negative for LEFT). Intended to be mapped to an encoder knob. Currently selected item changes
MoveFocusForward150) Binary Equivalent to pressing the TAB key on the keyboard Currently focused pane changes
MoveFocusBackward151) Binary Equivalent to pressing the SHIFT+TAB key on the keyboard Currently focused pane changes
MoveFocus152) Relative Move focus forward or backwards the specified number of panes (negative for SHIFT+TAB). Intended to be mapped to an encoder knob. Currently focused pane changes
ChooseItem153) Binary Equivalent to double clicking the currently selected item Context dependent
AutoDjAddBottom154) Binary Add selected track(s) to Auto DJ Queue (bottom). Append track(s) to Auto DJ playlist
AutoDjAddTop155) Binary Add selected track(s) to Auto DJ Queue (top). Prepend track(s) to Auto DJ playlist
font_size_increment156) Binary Increase the size of the library font. If the row height is smaller than the font-size the larger of the two is used. Library view
font_size_decrement157) Binary Decrease the size of the library font Library view
font_size_knob158) Relative Increase or decrease the size of the library font Library view

[Controls]

Key/ControlRangeWhat it doesOn-screen feedback
touch_shift159)binaryOnce enabled, all touch tab events are interpreted as right click. This control has been added to provide touchscreen compatibility in 2.0 and might be replaced by a general modifier solution in 2.1All Widgets

Effects framework

The effects framework was introduced in Mixxx 2.0.

EffectRack Controls
[Group] Key/Control Range What it does
[EffectRack1] num_effectunits integer, read-only The number of EffectUnits in this rack
EffectUnit Controls
[Group] Key/Control Range What it does
[EffectRack1_EffectUnitN] chain_selector +1/-1 Select EffectChain preset. > 0 goes one forward; < 0 goes one backward.
[EffectRack1_EffectUnitN] clear binary Clear the currently loaded EffectChain in this EffectUnit.
[EffectRack1_EffectUnitN] enabled binary, default true If true, the EffectChain in this EffectUnit will be processed. Meant to allow the user a quick toggle for the effect unit.
[EffectRack1_EffectUnitN] 160) focused_effect 0..num_effects 0 indicates no effect is focused; >0 indicates the number of the focused effect. Focusing an effect only does something if a controller mapping changes how it behaves when an effect is focused.
[EffectRack1_EffectUnitN] group_[ChannelI]_enable binary Whether or not this EffectChain applies to Deck I
[EffectRack1_EffectUnitN] group_[Headphone]_enable binary Whether or not this EffectChain applies to the Headphone output
[EffectRack1_EffectUnitN] group_[Master]_enable binary Whether or not this EffectChain applies to the Master output
[EffectRack1_EffectUnitN] group_[SamplerJ]_enable binary Whether or not this EffectChain applies to Sampler J
[EffectRack1_EffectUnitN] loaded binary, read-only Whether an EffectChain is loaded into the EffectUnit
[EffectRack1_EffectUnitN] mix 0.0..1.0 The dry/wet mixing ratio for this EffectChain with the EngineChannels it is mixed with
[EffectRack1_EffectUnitN] next_chain binary Cycle to the next EffectChain preset after the currently loaded preset.
[EffectRack1_EffectUnitN] num_effects integer, read-only The number of Effects that this EffectChain has
[EffectRack1_EffectUnitN] num_effectslots integer, read-only The number of effect slots available in this EffectUnit.
[EffectRack1_EffectUnitN] prev_chain binary Cycle to the previous EffectChain preset before the currently loaded preset.
[EffectRack1_EffectUnitN] 161) show_focus binary Whether to show focus buttons and draw a border around the focused effect in skins. This should not be manipulated by skins; it should only be changed by controller mappings.
[EffectRack1_EffectUnitN] 162) show_parameters binary Whether to show all the parameters of each effect in skins or only show metaknobs.
[EffectRack1_EffectUnitN] super1 0.0..1.0 The EffectChain superknob. Moves the metaknobs for each effect in the chain.
Effect Controls
[Group] Key/Control Range What it does
[EffectRack1_EffectUnitN_EffectM] clear binary Clear the currently loaded Effect in this Effect slot from the EffectUnit.
[EffectRack1_EffectUnitN_EffectM] effect_selector +1/-1 Select Effect – >0 goes one forward, <0 goes one backward.
[EffectRack1_EffectUnitN_EffectM] enabled binary, default true If true, the effect in this slot will be processed. Meant to allow the user a quick toggle for this effect.
[EffectRack1_EffectUnitN_EffectM] loaded binary, read-only Whether an Effect is loaded into this EffectSlot
[EffectRack1_EffectUnitN_EffectM] next_effect binary Cycle to the next effect after the currently loaded effect.
[EffectRack1_EffectUnitN_EffectM] num_parameters integer, read-only The number of parameters the currently loaded effect has. 0 if no effect is loaded
[EffectRack1_EffectUnitN_EffectM] num_parameterslots integer, read-only The number of parameter slots available.
[EffectRack1_EffectUnitN_EffectM] num_button_parameters integer, read-only The number of button parameters the currently loaded effect has. 0 if no effect is loaded
[EffectRack1_EffectUnitN_EffectM] num_button_parameterslots integer, read-only The number of button parameter slots available.
[EffectRack1_EffectUnitN_EffectM] 163) meta 0..1 Controls the parameters that are linked to the metaknob.
[EffectRack1_EffectUnitN_EffectM] prev_effect binary Cycle to the previous effect before the currently loaded effect.
EffectParameter Controls
[Group] Key/Control Range What it does
[EffectRack1_EffectUnitN_EffectM] parameterK double The scaled value of the Kth parameter. See the Parameter Values section for more information.
[EffectRack1_EffectUnitN_EffectM] parameterK_link_inverse bool The link direction of the Kth parameter to the effect's metaknob.
[EffectRack1_EffectUnitN_EffectM] parameterK_link_type enum The link type of the Kth parameter to the effects's metaknob.
[EffectRack1_EffectUnitN_EffectM] parameterK_loaded binary, read-only Whether or not the Kth parameter slot has an effect parameter loaded into it.
[EffectRack1_EffectUnitN_EffectM] parameterK_type integer, read-only The type of the Kth parameter value. See the Parameter Value Types table.
[EffectRack1_EffectUnitN_EffectM] button_parameterK double The value of the Kth parameter. See the Parameter Values section for more information.
[EffectRack1_EffectUnitN_EffectM] button_parameterK_loaded binary, read-only Whether or not the Kth parameter slot has an effect parameter loaded into it.
[EffectRack1_EffectUnitN_EffectM] button_parameterK_type integer, read-only The type of the Kth parameter value. See the Parameter Value Types table.

In the above table,

  • EffectRack1 leaves room for future expansion to multiple EffectRacks.
  • N ranges from 1 to [EffectRack1],num_effectunits, inclusive.
  • M ranges from 1 to [EffectRack1_EffectUnitN],num_effectslots, inclusive. (For a given value of N)
  • K ranges from 1 to [EffectRack1_EffectUnitN_EffectM],num_parameters, inclusive. (For given values of N and M)
  • I ranges from 1 to [Master],num_decks, inclusive.
  • J ranges from 1 to [Master],num_samplers, inclusive.

Linking Values

Effect parameters can be linked to the effect's metaknob. This linkage can be user-controlled by changing the link_type and the link_inverse control of the parameter. The default link type is loaded from the effect parameter's manifest's linkHint property.

Link TypeInteger ValueIntepretation
None 0 Not controlled by the metaknob
Linked 1 Controlled by the metaknob as it is
Linked Left 2 Controlled by the left side of the metaknob
Linked Right 3 Controlled by the right side of the metaknob
Linked Left Right 4 Controlled by both sides of the metaknob
Link InverseInteger ValueIntepretation
Normal 0 Linked in equal relation
Inverse 1 Linked in an inverse relation.

EQs and filters

Starting in Mixxx 2.0, the equalizers and filter controls have been moved to special effects units. The EQs are controlled by [EqualizerRack1_[ChannelN]_Effect1] and the filter knob is controlled by [QuickEffectRack1_[ChannelN]]. Users can choose between several options for the effects loaded in these racks in the Equalizers section of the Preferences window.

Deprecated controls

[Group] Key/Control Range What it does On-screen feedback Replacement
[ChannelN] beatloop positive real number Setup a loop over the set number of beats. A loop is shown over the set number of beats. beatloop_size and beatloop_toggle
[ChannelN] jog -3.0..3.0 Affects relative play speed & direction for short instances (additive & is automatically reset to 0) waveform JavaScript engine.scratch functions
[ChannelN] reloop_exit binary Toggles the current loop on or off. If the loop is ahead of the current play position, the track will keep playing normally until it reaches the loop. Loop range in waveform activates or deactivates. reloop_toggle
[ChannelN] scratch -3.0..3.0 Affects play speed & direction (differently whether currently playing or not) (multiplicative) Waveform JavaScript engine.scratch functions
[ChannelN] filter164),165) binary Toggles the filter effect Filter button [QuickEffectRack1_[ChannelN], enabled
[ChannelN] filterDepth166),167) default Adjusts the intensity of the filter effect Filter depth knob [QuickEffectRack1_[ChannelN], super1
[ChannelN] filterLow168) 0.0..1.0..4.0 Adjusts the gain of the low EQ filter LOW knob [EqualizerRack1_[ChannelN]_Effect1], parameter1
[ChannelN] filterLowKill169) binary Holds the gain of the low EQ to -inf while active LOW kill knob [EqualizerRack1_[ChannelN]_Effect1], button_parameter1
[ChannelN] filterMid170) 0.0..1.0..4.0 Adjusts the gain of the mid EQ filter MID knob [EqualizerRack1_[ChannelN]_Effect1], parameter2
[ChannelN] filterMidKill171) binary Holds the gain of the mid EQ to -inf while active MID kill knob [EqualizerRack1_[ChannelN]_Effect1], button_parameter2
[ChannelN] filterHigh172) 0.0..1.0..4.0 Adjusts the gain of the high EQ filter HIGH knob [EqualizerRack1_[ChannelN]_Effect1], parameter3
[ChannelN] filterHighKill173) binary Holds the gain of the high EQ to -inf while active HIGH kill knob [EqualizerRack1_[ChannelN]_Effect1], button_parameter3
[Flanger] lfoDepth174) default Adjusts the intensity of the flange effect Depth knob No direct replacement. See effects frameworks section
[Flanger] lfoDelay175) 50..10000 Adjusts the phase delay of the flange effect in microseconds Delay knob No direct replacement. See effects frameworks section
[Flanger] lfoPeriod176) 50000..2000000 Adjusts the wavelength of the flange effect in microseconds LFO knob No direct replacement. See effects frameworks section
[ChannelN] flanger177) binary Toggles the flange effect FLANGER button No direct replacement. See effects frameworks section
[ChannelN] beatloop_X178) toggle Setup a loop over X beats. A control exists for X = 0.03125, 0.0625, 0.125, 0.25, 0.5, 1, 2, 4, 8, 16, 32, 64 A loop is shown over X beats. [ChannelN], beatloop_X_activate
[ChannelN] Hercules1 ? deprecated ?
[ChannelN] Hercules2 ? deprecated ?
[ChannelN] Hercules3 ? deprecated ?
[ChannelN] Hercules4 ? deprecated ?
[ChannelN] NextTask ? deprecated ?
[ChannelN] NextTrack ? deprecated ?
[ChannelN] PrevTask ? deprecated ?
[ChannelN] PrevTrack ? deprecated ?
[ChannelN] transform ? deprecated ?
[Master] headVolume 0.0..1.0..5.0 adjust headphone volume Headphone Gain knob [Master] headGain
[Master] volume 0.0..1.0..5.0 adjust master volume Master Gain knob [Master] gain
[Playlist] LoadSelectedIntoFirstStopped binary Loads the currently highlighted song into the first stopped deck Waveform view [Library] ChooseItem
[Playlist] SelectNextPlaylist binary Switches to the next view (Library, Queue, etc.) Library sidebar [Library] MoveDown
[Playlist] SelectPrevPlaylist binary Switches to the previous view (Library, Queue, etc.) Library sidebar [Library] MoveUp
[Playlist] SelectPlaylist relative value Scrolls the given number of items (view, playlist, crate, etc.) in the side pane (can be negative for reverse direction). Library sidebar
[Playlist] ToggleSelectedSidebarItem179) binary Toggles (expands/collapses) the currently selected sidebar item. Library sidebar [Library] ChooseItem or [Library] MoveRight
[Playlist] SelectNextTrack binary Scrolls to the next track in the track table. Library track table highlight [Library] MoveDown
[Playlist] SelectPrevTrack binary Scrolls to the previous track in the track table. Library track table highlight [Library] MoveUp
[Playlist] SelectTrackKnob relative value Scrolls the given number of tracks in the track table (can be negative for reverse direction). Library track table highlight [Library] MoveVertival
1) , 2) , 3) , 4) , 5) , 6) , 22) , 40) , 54) , 55) , 65) , 71) , 104) , 122) , 123) , 124) , 125) , 137) , 138) , 139) , 140) , 179) introduced in Mixxx v1.11.0
7) , 8) , 9) , 12) , 13) , 14) , 15) , 16) , 17) , 18) , 23) , 26) , 30) , 31) , 41) , 42) , 44) , 45) , 46) , 56) , 60) , 69) , 80) , 83) , 86) , 90) , 91) , 92) , 93) , 94) , 100) , 101) , 108) , 109) , 110) , 111) , 114) , 119) , 120) , 121) , 126) , 127) , 129) , 135) , 154) , 155) , 156) , 157) , 158) , 159) , 164) , 166) introduced in Mixxx v2.0.0
10) , 11) , 25) , 32) , 37) , 38) , 43) , 48) , 49) , 57) , 72) , 75) , 87) , 95) , 96) , 105) , 106) , 107) , 115) , 116) , 117) , 118) , 128) , 130) , 131) , 132) , 133) , 134) , 136) , 178) introduced in Mixxx v1.10.0
19) , 21) , 50) , 52) , 59) , 70) , 89) , 99) , 113) introduced in Mixxx v1.9.0
20) , 27) , 28) , 29) , 33) , 34) , 35) , 36) , 39) , 58) , 81) , 82) , 84) , 85) , 97) , 98) , 112) , 141) , 142) , 143) , 144) , 145) , 146) , 147) , 148) , 149) , 150) , 151) , 152) , 153) , 160) , 161) , 162) , 163) introduced in Mixxx v2.1.0
24) , 47) , 51) changed in Mixxx v1.10.0
53) introduced in Mixxx v1.9.2
61) , 62) , 63) , 64) , 66) , 67) , 68) , 73) , 74) , 76) , 78) , 88) , 102) , 103) introduced in Mixxx v1.8.0
77) , 79) Changed in Mixxx v2.1.0
165) , 167) , 168) , 169) , 170) , 171) , 172) , 173) , 174) , 175) , 176) , 177) deprecated in Mixxx v2.0.0
Translations of this page:
mixxxcontrols.txt · Last modified: 2017/04/14 10:50 by be.ing