Updated controller mappings for Mixxx for the Behringer CMD Studio 2a controller.
Placeholder repo until I update it for merge to upstream.
- Loop saving controls. (Requires Mixxx 2.4 or greater.)
- Fader start.
- Quantize.
- Master volume/gain on Deck A high fx while mode-shifted.
- Channel pregain on deck mid fx while mode-shifted.
Based off https://github.com/mixxxdj/mixxx/wiki/behringer_cmd_studio_2a, refer to those docs for a starter.
Preferences have been split into a separate file Behringer-CMDStudio2a-Enhanced-preferences.js. If you take a copy of this file and install it to ~/.mixxx/controllers then any edits you make will persist through version upgrades. This avoids you needing to edit the file every time the controller defintion is updated.
As new options are added you'll have sensible defaults, but if you want to change an option added since you copied the file, you'll either need to copy the option in yourself, or take a fresh copy and make your changes by hand again.
The MODE button has changed from the orginal mapping to enable a more traditional "shift is only active while you hold the MODE key down" behaviour.
If you wish it to return to the old default where the MODE button uses "press once to enable mode-shift for the next command, or press twice to enable mode-shift lock", you can set holdToModeShift value in the preferences file to true.
In vinyl mode the top of the jog wheels enable scratching, and when MODE SHIFTED they'll function at 10x sensitivity to let you scrub through a track quickly.
You can also edit the jog wheel sensitivity in the preferences file if you need to.
The headphone knob controls headphone volume/gain by default, and when mode-shifted controls the headphone mix. If you'd prefer to swap these behaviours then change the headGainIsDefault value to false in the preferences file.
While mode-shifted, the Deck A high FX knob controls the master volume/gain.
While mode-shifted, the mid FX knob controls the gain applied to the deck before EQ or fader is applied. (Use to avoid clipping.)
By default the decks now start in vinyl mode, if you'd rather start in CD mode like the original controller mapping you can change the startInVinylMode option in the preferences file to false.
The Vinyl button will toggle between vinyl mode on/off, unless you're mode-shifting, in which case it toggles recording on/off.
With mode-shift or mode-lock on, pressing the Vinyl button will toggle recording mode.
This keybind doesn't make a whole lotta logical sense, but I wanted to have recording toggleable from just the controller and this was the least-confusing place to put it.
With mode-shift or mode-lock on, pressing the Sync button will disable sync lock and reset the deck playback rate to default.
Load A/Load B work as normal without the mode-shift key active. If you have mode-shift or mode-lock enabled then Load A/Load B will clone the playing track into deck A or B. (Deck cloning loads the cloned deck and sets it playing from the same point/bpm/etc.)
Pressing the File button with a track selected will load it into the first available stopped deck.
Pressing the File button while mode-shift is active will start previewing the currently selected track, or stop the current preview from playing.
You can stop the preview deck from automatically opening and closing as you do this by setting autoOpenPreviewDeck to false in the preferences file.
With mode-shift or mode-lock active the plus/minus buttons will beatjump forwards or backwards by the beatjump amount. This takes priority over other uses of the plus/minus buttons.
The Assign A button is now an "edit mode" switch that cycles between three editing modes:
- First is "sample" editing mode, with red LED.
- Second is "loop" editing mode with blue LED.
- This is "intro-outro" editing mode with flashing red/blue LED.
If you want to change the order of the "edit modes", you can do this in the editModes section of the preferences file. You can also customize the startInEditMode to pick which edit mode to start in when you fire up Mixxx.
- The hotcue buttons give access to hotcues 1-4.
- The sample buttons give access to sample banks 1-4.
This is the default behaviour from the old controller mapping.
- Assign B toggles loop enabled. (This applies to all modes, not just loop editing mode.)
- Plus/minus control loop in/loop out markers.
- The hotcue buttons and sample buttons become beatloop buttons, or when you mode-shift with the mode button they will alter the beatjump size instead. From the top: fractional beats on the left from 1/8 to 1, and multiple-beat loops on the right from 2 to 16.
If you wish to have a different range of durations to bind for the beatloops you can edit the beatLoops property in the preferences file.
- The hotcue buttons now grant access to hotcues 5-8 instead of 1-4.
- The sampler buttons now activate intro-start and intro-end on 1 and 2; and outro-start and outro-end on 3 and 4. If you mode-shift with the mode button it will clear the markers.
Intent of this mode is to help you prepare or cue up a track.
How you make use of the hotcues is up to you, but I like to stick the start/end of the beat or the melody (whichever makes sense for the track) on hotcue 5 and 7, and colour them Green for Groove; then stick start/end vocals on 6 and 8, colouring them Violet for Vocals.
The Assign B button is your loop enable/disable/remove and save/load button.
- Press once to toggle whether your current loop is enabled or disabled.
- With mode-shift or mode-lock active Assign B will delete the current loop.
- If you hold Assign B down, pressing the hotcue 1-4 buttons will save the current loop to the hotcue or load it if one is already saved.
- Holding Assign B while mode-shifted or mode-locked and pressing hotcue 1-4 will clear the hotcue. This finger-twister is provided to preserve expected button combo behaviours, but you may find it easier to just use the regular hotcue clearing controls from within sample editing mode.
For simplicity, hotcues 5-8 aren't reachable for now to save loops to. This may change in a future version.
With mode-shift active the channel faders will behave in "fader start/stop" mode, where fading up from a zero position will start the track playing from the current position, and fading down to zero will stop the track and return to the cue point.
If you just want the track to stop at the current position on fader stop, the faderStopGotoCue setting can be set to false in your preferences file.
You can toggle quantize for a deck with mode-shift + pfl (the "cue a" and "cue b" buttons). This binding doesn't have a handy mnemonic, but it seems to be used in a few other controller bindings - so I shamelessly borrowed it from there.