7. Controlling Mixxx

Mixxx can be controlled with a keyboard, a mouse, MIDI/HID controllers, time-code records/CDs, or a combination of these. The choice usually depends on your budget or style of DJing.

7.1. Using a Mouse and Touchpad

Use your mouse to interact with the controls in the Mixxx User Interface on your computer screen. You can perform actions by pointing and clicking with your mouse.

  • Single Left Click: Performing a left mouse click on buttons triggers the default action for that control. Moreover if you click on a value in the track list of the Mixxx library, you can change the value. For example the year of a track.

  • Double Left Click: Double-click on any knob or fader to reset it to its default value. This is especially useful on touchscreens as executing a right-click on them is usually tedious.

  • Single Right Click: On most buttons, performing a right click triggers a different action than a left click. You can return any knob or fader to its default value by right-clicking that control.

  • Mouse Drag: Click on a knob or fader, hold the left mouse button and move your cursor to change the value of the control. Use mouse drag to drop tracks from the file list to the decks, crates, playlists, etc.

  • Mouse Wheel: Just like Mouse Drag, you can change knob and fader values by placing the cursor over the control and moving the mouse wheel.


If you hover with the mouse over a control (e.g. the crossfader) in the Mixxx user interface, the tooltip lists the left- and right-click action respectively.


On a Macbook or a computer with a touchpad that lacks mouse buttons, a two-finger click gesture is often treated as a right click.


Using the Mouse drag/wheel on the waveforms you can adjust zoom and playback rate of the tracks. For more information, go to Waveform Displays.

7.2. Using a Keyboard

Keyboard shortcuts

Mixxx Keyboard shortcuts (for en-us keyboard layout)

Controlling Mixxx with a keyboard is handy. Unlike mouse control, the keyboard allows you to manage things simultaneously. For example, you can start playing a track on deck 1 whilst stopping deck 2 at the same time.

The default mapping for English keyboards is depicted in the figure above. It is divided into a left-hand side for deck 1 and right-hand side for deck 2. Please note that you can also access the functions through Mixxx’s interface.

For some user groups, like those using controllers or vinyl control, it might be useful to enable/disable the keyboard mappings at runtime. You can do so by clicking Options ‣ Enable Keyboard Shortcuts.


If you hover with the mouse over a control (e.g. the crossfader) in the Mixxx user interface, the tooltip lists the keyboard shortcuts of the control among a description of the control.


For a list of default shortcuts, go to Keyboard mapping table.

Customizing the keyboard mapping

Mixxx allows you to customize the keyboard control. For more information, go to:

7.3. Using MIDI/HID Controllers

Mixxx supports MIDI and HID controllers which are external hardware devices used to control audio applications. Many DJs prefer the hands-on feel of a controller with Mixxx because it can feel similar to using a real mixer and turntables or CDJ.

Loading a controller mapping

Mixxx Preferences - Loading a controller mapping

Mixxx Preferences - Loading a controller mapping

Without loading the correct mapping, your controller does not work with Mixxx.

  1. Connect your controller(s) to your computer

  2. 关于 Mixxx

  3. Go to Preferences ‣ Controllers

  4. Select your device from the list of available devices on the left, and the right pane will change

  5. Select the mapping for your controller from the Load Mapping drop-down menu

  6. Make sure that the Enabled checkbox is ticked

  7. Click Apply and Mixxx can now be controlled by your controller(s).

  8. Repeat step 4-7 for any of the controllers you want to use


If you do not find a connected device in the list, make sure to install any necessary drivers for that device.

Supported controllers

Mixxx can use any MIDI/HID controller that is recognized by your OS (some may require drivers), as long as there is a MIDI/HID mapping file to tell Mixxx how to understand it. Mixxx comes bundled with a number of mappings for various devices. There are two levels of controller mappings:

  • Mixxx Certified Mappings: These mappings are verified by the Mixxx Development Team.

  • Community Supported Mappings: These mappings are provided and have been verified as working by the Mixxx community, but the Mixxx Development Team is unable to verify their quality because we don’t have the devices ourselves. They might have bugs or rough edges.

If you run into issues with any of these mappings, please file a bug report on our Bug Tracker or tell us about it on our mailing list, forums, or IRC channel. Device support varies for each supported OS, so make sure to consult the documentation of the device.


Additional mappings are available in the Controller mapping forum.


Before purchasing a controller to use with Mixxx, consult our Hardware Compatibility wiki page. It contains the most up-to-date information about which controllers work with Mixxx and the details of each.

Installing a mapping from the forum

To use a controller mapping that did not come bundled with Mixxx, place the controller mapping in your User Mappings folder. To open it , go to Preferences ‣ Controllers and click the Open User Mapping Folder button. Alternatively, use your OS file browser to navigate there. The locations and more details can be found in The Mixxx Settings Directory.

If the mapping was posted as a .zip file, first extract the .zip file by right clicking on it in your file browser and selecting the option for extracting an archive or compressed folder. Copy the .xml file into your User Mapping folder. If there is a .js file, also copy that to your User Mapping folder. Restart Mixxx and load the mapping.

Map your own controller

There is no mapping available for your controller or you want to change an existing mapping? You can map your controller by using the Controller Wizard or take full control with the MIDI Scripting support in Mixxx.


Go to Adding support for your MIDI/HID Controller for detailed information.

7.4. Using Timecode Vinyl Records and CDs

Vinyl control allows a user to manipulate the playback of a track in Mixxx using a turntable or CDJ as an interface. In effect, it simulates the sound and feel of having your digital music collection on vinyl. Many DJs prefer the tactile feel of vinyl, and vinyl control allows that feel to be preserved while retaining the benefits of using digital audio.


Go to 黑胶控制 for detailed information.