13. Appendix

13.1. Keyboard mapping table

Shortcuts let you work more efficiently. This table lists the default keyboard shortcuts for accessing Mixxx with an English keyboard layout. Depending on your language settings the defaults may be different.

New in version 2.0: Passthrough, Vinylcontrol Mode, Vinylcontrol Cueing, and Single Deck Vinylcontrol Toggle shortcuts

Changed in version 2.0: Auto DJ shortcuts, Esc key exit search and leave focus

Function Deck 1 Deck 2 Master
Crossfade Left     G
Crossfade Right     H
Small Crossfade Left     Shift + G
Small Crossfade Right     Shift + H
Activate/Disable Effects Unit 5 0  
Headphone Cue (Pre-fader listen) T Y  
Bass Kill B N  
Load selected track to deck Shift + left Shift + right  
Unload track from deck Alt + Shift + left Alt + Shift + right  
Playback D L  
Seek Backwards A J  
Reverse Playback Shift + A Shift + J  
Seek Forwards S K  
Tempo Adjust Down F1 F5  
Tempo Adjust Up F2 F6  
Small Tempo Adjust Down Shift + F1 Shift + F5  
Small Tempo Adjust Up Shift + F2 Shift + F6  
Temporary Tempo Adjust Down F3 F7  
Temporary Tempo Adjust Up F4 F8  
Small Temporary Tempo Adjust Down Shift + F3 Shift + F7  
Small Temporary Tempo Adjust Up Shift + F4 Shift + F8  
Tempo (BPM) Sync 1 6  
BPM Tap Tempo Adjust Shift + ! Shift + ^  
Cue and Loop
Set Cuepoint Shift + D Shift + L  
Cue F ;  
Cue Go-to-and-stop Shift + F Shift + :  
Activate 4 Beat Loop Q U  
Halve Beat Loop Size W I  
Double Beat Loop Size E O  
Set Loop In Point 2 7  
Set Loop Out Point (Activates Loop) 3 8  
Toggle Loop On/Off 4 9  
Set Hot cue 1 Z M  
Set Hot cue 2 X ,  
Set Hot cue 3 C .  
Set Hot cue 4 V /  
Clear Hot cue 1 Shift + Z Shift + M  
Clear Hot cue 2 Shift + X Shift + <  
Clear Hot cue 3 Shift + C Shift + >  
Clear Hot cue 4 Shift + V Shift + ?  
Microphone Talkover     `
Auto DJ
Shuffle Auto DJ playlist     Shift + F9
Skip next track in Auto DJ     Shift + F10
Fade to next track in Auto DJ     Shift + F11
Toggle Auto DJ on/Off     Shift + F12
Preview Deck
Load Selected Track And Play     Alt + Return
Start/Stop     Return
Seek Backwards     Alt + Left
Seek Forwards     Alt + Right
Vinyl Control
Passthrough Ctrl + J Ctrl + K  
Vinylcontrol Mode Ctrl + Shift + Y Ctrl + Shift + U  
Vinylcontrol Cueing Ctrl + Alt+ Y Ctrl + Alt + U  
Single Deck Toggle / Swap Decks Ctrl + T Ctrl + T  
Search bar
Focus Ctrl + F
Clear input Ctrl + Back
Exit search and leave focus ESC
Select all files in current list Ctrl + A
Select group of files in current list Click first item, hold Shift key, click last item

See also

Mixxx allows you to customize the keyboard shortcuts. For more information, and to download a keyboard mapping image, go to Using a Keyboard.

13.2. Application shortcuts

Use these shortcuts to access features available in the menu on top of the application window.

New in version 2.0: Added Show Effect Rack, Maximize Library, and Show Cover Art shortcuts. Added a Developer Tools option to the Developer menu which provides various useful debugging tools.

Changed in version 2.0: Shortcuts for Enable Vinyl Control 1-4.

Function Key
File menu
Load Track to Deck 1 Ctrl + O
Load Track to Deck 2 Ctrl + Shift + O
Library menu
Add new Playlist Ctrl + N
Add new Crate Ctrl + Shift + N
View menu
Show Samplers Ctrl + 1
Show Microphone Section Ctrl + 2
Show Vinyl Control Section Ctrl + 3
Show Preview Deck Ctrl + 4
Show Effect Rack Ctrl + 5
Show Cover Art Ctrl + 6
Maximize Library Space
Full Screen (Windows & Linux) F11
Full Screen (Mac OS X) Shift + Command + F
Options menu
Enable Vinyl Control 1 Ctrl + T
Enable Vinyl Control 2 Ctrl + Y
Enable Vinyl Control 3 Ctrl + U
Enable Vinyl Control 4 Ctrl + I
Enable Live Broadcasting Ctrl + L
Record Mix Ctrl + R
Enable Keyboard Shortcuts Ctrl + `
Open Preferences (Windows & Linux) Ctrl + P
Open Preferences (Mac OS X) Ctrl + ,
Exit Mixxx Ctrl + Q
Developer menu
Reload skin Ctrl + Shift + R
Developer Tools Ctrl + Shift + T
Stats: Base Bucket Ctrl + Shift + B
Stats: Experiment Bucket Ctrl + Shift + E
Debugger Enabled Ctrl + Shift + D


The Ctrl key on Windows & Linux is equivalent to the Command key on Mac OS X. The Alt key on Windows & Linux is equivalent to the Option key on Mac OS X. Application shortcuts are not customizable.


The Developer menu is available if Mixxx is started using the Command line options.

13.3. Command line options

Mixxx is designed to be as user-friendly as possible. As such, its command line options are only useful for development or debugging, as they make these tasks easier. Command line options are case-sensitive.

    New in version 2.0:
  • Show debug tooltips

  • Provide extra skins when developer mode is enabled.

  • Adds the debugger during skin parsing in --developer mode

  • Adds “Enable Base” and “Enable Experiment” option in --developer mode

  • Added --safeMode option.

Option Description
[FILE] Load the specified music file(s) at start-up. Each file you specify will be loaded into the next virtual deck. Supported file types: mp3, ogg, aiff, aif, wav, flac, and optional unprotected aac (m4a)
–resourcePath PATH Top-level directory where Mixxx should look for its resource files such as MIDI mappings, overriding the default installation location.
–pluginPath PATH Top-level directory where Mixxx should look for sound source plugins in addition to default locations.
–settingsPath PATH Top-level directory where Mixxx should look for user settings files such as the library database and preferences configuration file.
–controllerDebug Causes Mixxx to display/log all controller data it receives and script functions it loads.
–developer Enables developer-mode. Includes extra log info, stats on performance, a Developer tools menu, extra developer skins, and provides useful information for skin writers in widget tooltips and logs .

Disables risky things at start up. This should help troubleshoot crashes at startup or if Mixxx won’t boot.

  • Automatically loads empty waveforms
  • Disables spinning vinyl widgets
  • Disables synchronization polling
  • Doesn’t open controllers by default
–locale LOCALE Use a custom locale for loading translations (e.g ‘fr’)
-f, –fullScreen Starts Mixxx in full-screen mode
-h, –help Display this help message and exit

13.4. Developer tools

To start Mixxx in Developer mode from a custom resource directory with MIDI and HID logging enabled, type the following line into the terminal and hit return:

./mixxx --controllerDebug --developer --resourcePath res

13.4.1. Experiment modes for rapid development and testing

    New in version 2.0:
  • Adds a static Experiment class with a tri-state mode flag that indicates whether the experiment mode is OFF, BASE, or EXPERIMENT.

  • Adds Developer‣Stats:Experiment Bucket and Developer‣Stats:Base Bucket. Each one toggles between OFF and BASE/EXPERIMENT so you can choose exactly what time spans you would like to collect in your base and experiment buckets.

  • Updates StatsManager to segment collected stats into a base and experiment bucket. This allows you to quickly measure the difference a code change has on relevant counters / timers within the same execution of Mixxx.

This is useful for quickly enabling and disabling a code change without a re-compile/re-run cycle to get an anecdotal sense of how it “feels” as well as a quantified sense of how it differs in terms of stats Mixxx collects.

All stats collected via the usual Counter/Timer/ScopedTimer/etc. tools are segmented into a BASE STATS and EXPERIMENT STATS section printed to the log on exit.

13.5. Version History

v2.0.0 (2015-12-31)

  • 4 Decks with Master Sync
  • New Effects Framework with 4 Effect Units and 5 Built-in Effects: * Flanger, Bit Crusher, Reverb, Echo, Filter * More to come!
  • Configurable, Resizeable User Interface with 3 Brand New Skins
  • Cover Art Display
  • Music Key Detection and Shifting
  • Vinyl Audio Pass-Through
  • 4 Microphone inputs and 4 Auxiliary inputs
  • MIDI Mapping GUI and Improved Learning Wizard
  • MusicBrainz metadata fetching
  • RGB Musical Waveforms
  • Hundreds of Bug Fixes and Improvements
  • New Pitch-Independent Algorithm for Better-Sounding Key-lock

For a full list of new features and bugfixes, go to: https://launchpad.net/mixxx/2.0.

v1.11.0 (2013-05-09)

  • Completely revamped Waveforms
  • Direct HID controller support
  • Point & Click Controller Mapping
  • Next Generation Beat Detection
  • Library History Feature
  • Improved AutoDJ
  • Beatloop Rolls
  • Preview Deck
  • Advanced Search
  • New and Improved User Manual
  • New Controller Support

For a full list of new features and bugfixes, go to: https://launchpad.net/mixxx/1.11.0.

v1.10.1 (2012-06-30)

  • Bugfixes

For a full list of bugfixes, go to: https://launchpad.net/mixxx/1.10.1.

v1.10.0 (2011-12-25)

  • Rewritten and Improved Vinyl Control Support
  • 4 Sampler Decks
  • Quantized Loops, Hotcues and Beatloops
  • Phase Synchronization
  • Beatgrid Adjust Feature
  • Microphone Support
  • Spinning Turntable Widgets and Waveform Scratching
  • M4A Support for Windows Vista and Windows 7 users
  • Brand New and Updated Skins
  • Accessibility Improvements
  • Limited Support for Internationalization
  • Revamped and Rewritten User Manual
  • Mixing engine improvements
  • Updated MIDI Mappings

For a full list of new features and bugfixes, go to: https://launchpad.net/mixxx/1.10.0.

See also

For an overview of previous versions, take a look at the timeline.