Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/faithvoid/herculesdj4set-remixxx

Variations of Mixxx/Traktor MIDI mappings for the Hercules DJ4Set DJ controller.
https://github.com/faithvoid/herculesdj4set-remixxx

Last synced: 8 months ago
JSON representation

Variations of Mixxx/Traktor MIDI mappings for the Hercules DJ4Set DJ controller.

Awesome Lists containing this project

README 

          
# Hercules DJ 4Set ReMiXXX Project

## Mixxx/Traktor MIDI remapping project for the Hercules DJ 4Set DJ controller. 

### This is still a work in progress to cram as much functionality into the controller as possible but all mappings are basically stage-ready.



There are 2 variations of mappings to choose from for Mixxx:



- Extended ReMiXXX (2-Deck) - Sets up decks C/D as loop pads/FX/volume knobs for decks A/B. This is most recommended, as in my opinion you can do a lot more with your mixes by focusing on 2 decks with this controller instead of 4.



- ReMiXXX (4-Deck) - Sets up a traditional 4-deck layout, with the pads acting as cue points with a total of 6 per deck (using shift). (**Not even close to ready, and not recommended.**)



And one variation for Traktor (as the default Traktor 4-deck mapping is fine):

- Extended ReMiXXX (2-Deck) - Sets up decks C/D as loop pads/FX/volume knobs for decks A/B. This is most recommended, as in my opinion you can do a lot more with your mixes by focusing on 2 decks with this controller instead of 4.

# Mixxx:

## Working:

- Full 2-Deck Mapping (4-Deck coming soon!)

- All buttons work as expected.

- Jogwheels (scratch by pressing the jogwheel in and, well, scratching, jog/seek by rotating the wheel without pressing!)

- LEDs: Hotcue, Sync, Recording, Mic On, Play (flashes to BPM), Cue (flashes to on-screen Cue), Headphone Cue / Pre-Fader Listen, Loop LEDs (for 1/2/4 beat loops)



## To Do:

- Keep Loop LEDs 1-3 on both decks enabled while a beatloop lower than 1 (but higher than 0) or higher than 4.

- Mappings: Finish 4-Deck version (~50%)



# Traktor:

## Working:

- Everything except fader soft takeover(?)



# 2-Deck Notes:

![](ExtendedReMiXXXLayout.jpg)



- All Deck A/B buttons/knobs/faders function as you would expect them to in other software / as you'd expect looking at the controller.



- C / D Mode slightly emulates a DDJ-400/Inpulse 500 in terms of layout for FX. The inspiration for setting the C/D deck mappings like this came from using my Hercules DJControl Compact, as that controller switches between cues/loops/FX/samples in a similar way.



- Adjusting the knobs/faders in A/B mode and switching to C/D mode and vice versa will keep the knobs/faders set to where you left them (aka soft takeover) until you return to the opposite deck mode and set the knobs/faders back to the exact position you see them on the screen. Be especially wary with the volume/pitch faders so you don't mess up your mix!



- All decks remember your last used Shift mode!



- To use this on Linux, you have download, make and run the HDJD drivers by nealey on GitHub in order to get the controller to show up in Mixxx or Traktor (or other DJ software), more about this can be found here: https://github.com/mixxxdj/mixxx/wiki/Hercules-Linux-Usermode-Driver



## FAQ:

- "Why doesn't my controller show up in Linux?"

- You need to download, make and run nealey's HDJD userspace driver from their GitHub repo! After that it works just fine in most DJ software such as Mixxx and Traktor in WINE. Note that you'll need to run it every time you want to use your controller!

- "Is there really no better option for using all 4 decks?"

- Not really, unless I'm missing something incredibly obvious. You can manually assign whatever buttons you want to suit your needs, but there's no real coherent way to fit all the functionality needed to use all 3 pad functions elegantly. I think most people should personally stick with using this controller as a fully-featured 2-deck instead but it's all up to personal preference.

- "How do I change the LED colour?"

- Try changing your desired LED's "0x90" code to to "0x91". This seems to correspond with Deck C/D LEDs (this is how I'm keeping the play button BPM synced between decks). Only some LEDs have alternate modes, so YMMV.

- "Do you accept pull requests?"

- I do, please help out if you can! I, as one woman working off vague documentation and DIYed reverse engineering tools, can only do so much to get this thing functional in Traktor/Mixxx, any and all help is much appreciate.



## Credits:

- Mixxx developers for making such incredible & flexible software.

- Orak from the Mixxx forums for the original Hercules DJ4Set script that some of this code is based off of.

- Neale Pickett (Nealey) for making the Hercules DJ Controller Driver that makes all of this possible!