User Tools

Site Tools


Hercules DJ Control MP3 e2

The Hercules DJ Control MP3 e2 is a USB MIDI controller without a built in sound card. It is compatible with Mixxx versions 1.8+ herc and later. It works in Linux 32/64 bits (from kernel ~2.6.27+), Windows (XP, Vista, 7), and MAC OS X (10.4.11 (Tiger)/ 10.5.x (Leopard)/ 10.6.x (Snow Leopard) 32-bit)

MIDI driver

The midi device on the MP3 e2 is NOT USB-midi class compliant. For that reason it requires specific drivers to be working on each OS.

MAC OS / Windows

Drivers for MAC OS X and Windows can be found on Hercules support page.


Hercules has released a common MIDI-driver for their DJ controllers. Read more on the page for Hercules Linux kernel module


As of Mixxx v1.11-beta2 this controller is supported through USB HID. This works without any additional kernel drivers. If the Hercules driver causes a kernel panic on your linux distribution you can use this feature.

Enable the controller in Ubuntu by following the steps below:

  1. Remove the hdjmod-dkms driver if installed:
    sudo apt-get remove hdjmod-dkms
  2. Add the Mixxx v1.11 repositories (use the mixxxbetas ppa until v1.11 final is released).
    sudo add-apt-repository ppa:mixxx/mixxxbetas
    sudo apt-get update
  3. Install Mixxx (remove older version prior to install):
    sudo apt-get install mixxx
  4. Plug-in the controller and run mixxx
  5. Go to Preferences, select and enable “Hercules ..” device listed under Controllers (do not select Midi Through!)

If the device is still not visible as a separate entry under “Controllers” you need to modify the device permissions using udev rules. First create the rule file:

sudo nano /etc/udev/rules.d/hercules-usb.rules

Add following lines to this file:

SUBSYSTEM=="usb_device", SYSFS{idVendor}=="06f8", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="06f8", MODE="0666"

Save the contents and restart udev:

sudo /etc/init.d/udev restart

Pull out the controller and plug it in again. Run mixxx and select “Preferences” → “Controllers” and you should be able to select and enable the controller.

Mapping for Mixxx

The Hercules MP3 e2 mapping for Mixxx is integrated in Mixxx so you don't have to download or install nothing.

Global controls

Number Control Function
8 Arrow up/down Scrolls to the prev/next track in the Playlist/tracktable
6 Folder Scrolls up to 10 tracks in the Playlist/tracktable
10 Files Scrolls down to 10 tracks in the Playlist/tracktable
18 Load A/B Loads the currently highlighted track into the corrisponding deck (A or B)
19 Crossfader Fades between left and right deck
7 Scratch Enable or disable the scratch mode on both decks
9 Automix Used as a master shift button to obtain more controls than those provided by Hercules.
For example: hold down the Automix button and than press the “pitchbend” buttons for adjust the pre-gain amplification

Deck / Channel specific controls

Number Control Simple function Shifted function
1 Pitchbend +/- Holds the pitch 4% higher while pressed Adjust the pre-gain amplification
2 Master Tempo Toggles a channels flanger effect on and off Enable key-lock for the specified deck (rate changes only affect tempo, not key)
3 Pitch knobs Adjusts playback pitch/speed Deck A: adjust the headphone volume
Deck B: adjust the cue/main mix in the headphone output
4 Loop/Fx Toggle the Loop/Hotcue mode for the keys buttons.
When the button is not lit up the loop buttons are enabled, when the button is lit up the hotcue's buttons are enabled
5 Equalizer knobs Adjusts the gain of the low/medium/high equalizer filter Nothing
11 1/2/3/4 buttons Loop mode:
1 - Sets the loop-in position to the current play position.
2 - Sets the loop-out position to the current play position.
3 and 4 - Toggles the current loop On or Off.
Hotcue mode:
1, 2, 3 and 4: If hotcue X is set, seeks the player to hotcue X's position. If hotcue X is not set, sets hotcue X to the current play position.
Loop mode:
Clears the loop-in/out sets.
Hotcue mode:
If hotcue X is set, clears its hotcue status.
12 Forward \ Backward Fast forward/backward Nothing
13 Sync Automatically sets pitch so the BPM of the other deck is matched Nothing
14 Play Starts or stop a loaded track Nothing
15 Cue Sets the cue point if a track is stoped and not at the current cue point
Stops track and returns to the current cue point if a track is playing.
Plays preview if a track is stopped at the cue point for as long as it's held down
16 Jog wheel Seeks forwards and backwards in a stopped track.
Temporarily changes the playback speed for playing tracks
Absolute sync of the track speed to the jog wheel if the scratch mode is enabled
17 Deck volume slider Controls the deck output volume Nothing
20 Headphone monitor Toggles this deck output to the headphones monitor on/off Nothing
hercules_dj_control_mp3_e2.txt · Last modified: 2013/10/13 10:36 by vtcavalcante