Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Supported controllers

openDJ uses Mixxx's controller mappings, so these MIDI and USB HID controllers load their mapping as soon as they're plugged in.

openDJ looks after these itself: each has a picture in the Controller Editor and a guide. Beta means nobody has tried it in openDJ on the real controller yet; if you have one, tell us how it goes. It becomes Supported once it has been tried and its mapping is settled.

ControllerStatusNotes
Pioneer DDJ-FLX4BetaTried on the hardware; the mapping is still settling.
Pioneer DDJ-400Beta–
Pioneer DDJ-200Beta–
Pioneer DDJ-SB3Beta–
Numark Mixtrack Platinum FXBeta–
Numark Mixtrack Pro FXBeta–
Numark V7BetaMixxx's mapping from 2012. The V7 runs its own platter motor; the picture is a sketch, not measured.
Hercules DJControl Inpulse 500Beta–
Allen & Heath Xone:K2BetaopenDJ's own two-deck mapping. Set the K2 to its factory settings: Latching Layers off, MIDI channel 15. openDJ's Mixer mapping (Allen & Heath Xone:K2 - Mixer) puts Mixer channels 1 to 4 on its columns, and Mixxx's mapping (Allen&Heath Xone K1/K2/K3) is still there to pick.
DJ TechTools Midi Fighter TwisterBetaTried on the hardware; the mapping is still settling.
Pioneer DDJ-SXBetaMixxx's mapping. Four decks; the pads have Hot Cue, Roll, Slicer and Sampler modes.
Pioneer DDJ-SX2BetaMixxx's DDJ-SX mapping: the SX2 sends the same MIDI. CAPTURE and the sequencer buttons do nothing yet.
Pioneer DDJ-RXBetaMixxx's DDJ-SX mapping plus QUANTIZE: the RX sends the SX2's MIDI. PAD FX mode plays rolls. The Sound Color FX buttons, CAPTURE and the sequencer buttons do nothing yet; the COLOR knobs work as filters.
Pioneer DDJ-FLX6BetaopenDJ's own mapping, written from Pioneer's MIDI message list.
Pioneer XDJ-RX3BetaopenDJ's own mapping for the all-in-one in PC control mode, written from AlphaTheta's MIDI message list.
Pioneer XDJ-AZBetaopenDJ's own mapping for the all-in-one in PC control mode, built on the XDJ-RX3 mapping from AlphaTheta's MIDI message list.
Pioneer DDJ-REV1Coming soonopenDJ's own mapping, written from Pioneer's MIDI message list.
Pioneer DDJ-1000Coming soonopenDJ's own mapping, written from Pioneer's MIDI message list. The jog screens stay dark: they need Pioneer's own protocol.
Pioneer DDJ-FLX10BetaopenDJ's own mapping, written from AlphaTheta's MIDI message list on top of the DDJ-FLX6's. The jog displays show the playhead, cue, BPM and time. MIX POINT, FX PART SELECT and the pad PAGE buttons do nothing yet.
Pioneer DDJ-800BetaopenDJ's own mapping, written from Pioneer's MIDI message list on top of the DDJ-FLX4's. The jog displays show BPM, time and the playhead. MEMORY, DELETE, the pad PAGE buttons and the COLOR FX buttons do nothing yet.
Native Instruments Traktor Kontrol S2 MK3BetaA USB HID controller, running Mixxx's HID mapping. No picture in the Controller Editor, and it can't be remapped there.
Native Instruments Traktor Kontrol S3BetaA USB HID controller, running Mixxx's HID mapping. No picture in the Controller Editor, and it can't be remapped there.
Native Instruments Traktor Kontrol S4 MK3BetaA USB HID controller, running Mixxx's HID mapping. Its two screens stay dark. No picture in the Controller Editor.
Native Instruments Maschine Mikro MK3BetaopenDJ's own HID mapping for the Groove Box: steps, live play and recording, grooves and kits on the pads, with its screen. No NI software needed; quit Maschine first. No picture in the Controller Editor.

Every mapping

ControllerMapping byControls listed
Akai LPD8Rob KNot yet
Akai MPD24klicoNot yet
Allen & Heath Xone:K2 - 2 DecksopenDJYes
Allen & Heath Xone:K2 - MixeropenDJYes
Allen&Heath Xone K1/K2/K3BeNot yet
American Audio Radius 2000 CH1Markus SteinbauerNot yet
American Audio Radius 2000 CH2Markus SteinbauerNot yet
American Audio VMS2Stefan NuernbergerNot yet
American Audio VMS4/4.1Anders Gunnarsson & Sean M. PappalardoNot yet
Arturia KeyLab Mk 1Sam WhitedYes
Behringer BCD2000GolzoNot yet
Behringer BCD3000ApostoNot yet
Behringer BCD3000 AdvancedJoachimNot yet
Behringer BCR2000ChristianNot yet
Behringer CMD Microtecywiz121Not yet
Behringer CMD MM-1Swiftb0yNot yet
Behringer CMD STUDIO 4aCraig EastonYes
Behringer DDM4000ChristianNot yet
Denon DN SC2000Jan Riewe, MobaNot yet
Denon HS5500Owen WilliamsNot yet
Denon MC3000 v0.995BeMixxxNot yet
Denon MC4000Tim RaeNot yet
Denon MC6000MK2Uwe Klotz a/k/a tapirNot yet
Denon MC7000OsZ, JLYes
DJ TechTools MIDI FighterRJ RyanNot yet
DJ TechTools MIDI Fighter SpectraSam WhitedYes
DJ TechTools MIDI Fighter Twistertock203, Sam WhitedYes
DJ-Tech CDJ-101zestoiNot yet
DJ-Tech DJM-101zestoiNot yet
DJ-Tech i-Mix ReloadvininimNot yet
DJ-Tech Kontrol OneRob KNot yet
DJ-Tech MIX-101rasdaNot yet
DJ-Tech Mixer OneRob KNot yet
Electrix TweakerBeNot yet
Evolution X-SessionAmias ChannerNot yet
FaderFox DJ2Sacha Berger, GosseynNot yet
Gemini CDMP-7000 LdjtrinidadNot yet
Gemini CDMP-7000 RdjtrinidadNot yet
Gemini FirstMixmcsquared88Not yet
Hercules DJ Console 4-MxjosepmaNot yet
Hercules DJ Console Mac EditionDaniel SvenssonNot yet
Hercules DJ Console Mk2Garth DahlstromNot yet
Hercules DJ Console MK4Dj korkNot yet
Hercules DJ Console RMXAnders GunnarssonNot yet
Hercules DJ Console RMX AdvancedAnders GunnarssonNot yet
Hercules DJ Console RMX2CircuitfryNot yet
Hercules DJ Control AIRrojaroYes
Hercules DJ Control InstinctMich WyserNot yet
Hercules DJ Control MP3Vittorio ColaoNot yet
Hercules DJ Control MP3 e2 / MP3 LE / GlowGianfe, Taucher and SBlaisotNot yet
Hercules DJ Control SteelStephane List, from the work of Anders GunnarssonNot yet
Hercules DJControl CompactOwen WilliamsYes
Hercules DJControl Inpulse 200DJ Phatso for Hercules Technical SupportYes
Hercules DJControl Inpulse 300DJ Phatso for Hercules Technical SupportYes
Hercules DJControl Inpulse 500DJ Phatso, Event1ne and Reset RebootNot yet
Hercules DJControl JogvisionDJ Phatso for Hercules Technical SupportYes
Hercules DJControl MIXDJ Phatso for Hercules Technical Support, contributions by Kerrick StaleyYes
Hercules DJControl StarlightDJ Phatso for Hercules Technical Support, contributions by Kerrick StaleyYes
Hercules P32 DJBeNot yet
Icon iControlsSam WhitedYes
Icon P1-Nano MIDI 1Sam WhitedYes
Intech TEK2–Yes
Ion Discover DJRick ProkupYes
Ion Discover DJ Projoachim,meltedpianomanNot yet
Keith McMillen Instruments QuNeoDaniel LejaNot yet
Kontrol DJ KDJ500bonkhead and dnineNot yet
Korg KAOSS DJSeb Dooris, Fayaaz Ahmed, Lee Arromba, Raphael QuastYes
Korg nanoKONTROLePoxiNot yet
Korg nanoKONTROL2Rob KNot yet
Korg nanoPAD2Rob KNot yet
M-Audio X-Session ProKarliNot yet
M-Vave SMC-MixerSam WhitedYes
M-Vave SMK-25 IISam WhitedYes
MIDI for lightMichael Stahl / DG3NECNot yet
MIDI Keyboard–Not yet
MidiTech MidiControl–Not yet
Mixman DM2 (Linux)Jan JockuschNot yet
Mixman DM2 (OS X)Joe M.Not yet
Mixman DM2 (Windows)Joe M.Not yet
MixVibes U-Mix Control 2peperNot yet
MixVibes U-Mix Control Pro 2tomtom (thomas-8)Not yet
Native Instruments Maschine Mikro MK3openDJNot yet
Native Instruments Traktor Kontrol F1Ilkka TuohelaNot yet
Native Instruments Traktor Kontrol S2 Mk1leifhelmNot yet
Native Instruments Traktor Kontrol S2 MK2BeNot yet
Native Instruments Traktor Kontrol X1Ilkka Tuohela <[email protected]>Not yet
Native Instruments Traktor Kontrol Z1djanttiNot yet
Novation DicerShaun ([email protected])Not yet
Novation LaunchpadMidiparseNot yet
Novation Launchpad MinimarczisNot yet
Novation Launchpad Mini MK3Christian NeumannNot yet
Novation Launchpad MK2MidiparseNot yet
Numark DJ2GoAlimantado, mod by CovalNot yet
Numark DJ2GO2 Touchtandy1000Not yet
Numark iDJ Live IINathan KorthNot yet
Numark Mixstream Prodanielkinahan and ptrex (aka audministrator)Not yet
Numark MIXTRACKMatteo ([email protected]), RAWRR, and uncleeugeneNot yet
Numark Mixtrack (Pro) 3Stéphane MorinYes
Numark MixTrack (Pro) IISNOWY, Armen Rizal, ninomp, special thanks to Thomas Preston and Ricecows ([email protected])Not yet
Numark Mixtrack PlatinumMatthew NicholsonNot yet
Numark Mixtrack Platinum FXEvoixmr mixxx 2.4 version updated from - QGazQ tweaks of Octopussy based on mapping from h67ma, bad1dea5, photoenix, Matthew Nicholson, Ending, Kaj BostromNot yet
Numark MixTrack ProMatteo ([email protected]), James Ralston, and D. J. Freije ([email protected])Not yet
Numark Mixtrack Pro FXh67ma, bad1dea5, photoenixNot yet
Numark N4Swiftb0yNot yet
Numark NS4FXTomáš Bažant, Erik Puschendorf, Matthew NicholsonNot yet
Numark NS6IISwiftb0yNot yet
Numark NS7Anders GunnarssonNot yet
Numark Omni ControlBaxterNot yet
Numark Party MixolafNot yet
Numark ScratchAl Hadebe(NotYourAverageAl)Not yet
Numark Total ControlSmashuu / David GnedtNot yet
Numark V7Mike BucceroniNot yet
Pioneer CDJ-2000Ilkka Tuohela <[email protected]>Not yet
Pioneer CDJ-350 CH1Kazuaki and DJ TigerNot yet
Pioneer CDJ-350 CH2Kazuaki and DJ TigerNot yet
Pioneer CDJ-850Ilkka Tuohela <[email protected]>Not yet
Pioneer DDJ-200Dan Giddins, Frank.Breitling at gmx.deYes
Pioneer DDJ-400Warker, nschloe, dj3730, jusko, tiesjanYes
Pioneer DDJ-800Robert904Yes
Pioneer DDJ-FLX10openDJ (from its DDJ-FLX6 mapping)Yes
Pioneer DDJ-FLX4Robert904Yes
Pioneer DDJ-FLX6openDJ (from the DDJ-FLX4 mapping by Robert904 and the DDJ-400 mapping)Yes
Pioneer DDJ-RXMaximilian Beiersdorfer, DJMaxergyYes
Pioneer DDJ-SBJoan Ardiaca JovéNot yet
Pioneer DDJ-SB2Be, Michael Stahl (DG3NEC)Yes
Pioneer DDJ-SB3Dancephy.comYes
Pioneer DDJ-SXMaximilian Beiersdorfer, DJMaxergyYes
Pioneer DDJ-SX2Maximilian Beiersdorfer, DJMaxergyYes
Pioneer XDJ-AZopenDJ (from its XDJ-RX3 mapping)Yes
Pioneer XDJ-RX3openDJ (from its DDJ-FLX4/FLX6 mappings)Yes
Reloop Beatmix 2/4 MK2Sébastien Blaisot <[email protected]>Yes
Reloop BeatpadChloé Avrillon (DJ Chloé)Not yet
Reloop Digital Jockey 2 ControllerTobias Rafreider and Sandor IvicsicsNot yet
Reloop Digital Jockey 2 Interface EditionDJ aKNot yet
Reloop Jockey 3 MEChris2000SPNot yet
Reloop MixageHorstBaerbel & gqzomerNot yet
Reloop Terminal Mix 2/4Sean M. Pappalardo (1.11), ronso0 (2.1 update)Not yet
Roland DJ-505Jan HolthuisYes
Soundless joyMIDIOzzy ChiuNot yet
Stanton DJC.4Martin Bruset Solberg, Christoph ZimmermannNot yet
Stanton SCS.1d (unfinished)Sean M. PappalardoNot yet
Stanton SCS.1mSean M. PappalardoNot yet
Stanton SCS.3dSean M. PappalardoNot yet
Stanton SCS.3d (alternate)sbalmerNot yet
Stanton SCS.3msbalmerNot yet
Tascam US-428Auto-converted by madjesta's PHP scriptNot yet
TrakProDJ iPadIlkka Tuohela <[email protected]>Not yet
Traktor Kontrol S2 MK3Michael SchmidtNot yet
Traktor Kontrol S3Owen WilliamsNot yet
Traktor Kontrol S4 MK2Owen Williams, Fayaaz AhmedNot yet
Traktor Kontrol S4 MK3Be, A. ColombierNot yet
Traktor MX2K7Not yet
Vestax SpinBill Good, based on the work of Anders GunnarssonNot yet
Vestax TyphoonbestdaniNot yet
Vestax Typhoon EnhancedbestdaniNot yet
Vestax VCI-100Anders GunnarssonNot yet
Vestax VCI-100 (MixVibes 3DEX Editon)Julius Alexander Kohout edler von DolnobranskyNot yet
Vestax VCI-100 Hile ModIlkka TuohelaNot yet
Vestax VCI-100MKIITakeshi SoejimaNot yet
Vestax VCI-300Uwe KlotzNot yet
Vestax VCI-400Owen Williams, Tobias RafreiderYes
Wireless DJ AppEvgen Bodunov / Ilya BirmanNot yet
Yaeltex MiniMixxxOwen WilliamsNot yet

Don't see yours, or does it misbehave? Tell us which one.