Hercules
| General | Download | Forums | Bugs | Wiki | IRC | Developer Mailing List |
|---|---|---|---|---|---|---|
| mixxx.org | Get Mixxx! | mixxx.org/forums | Mixxx launchpad bugs | mixxx.org/wiki | #mixxx on freenode | Mixxx-devel mailing list |
Welcome the Mixxx page for Hercules devices, Mixxx is the world's best free open source DJ software and the only one that runs on Windows, Mac OSX and Linux (download Mixxx)... Hercules does not directly develop or support troubleshooting of Mixxx, so please direct questions/bugs encountered/comments/praise about Mixxx to the Mixxx community sites at the top of this page.
Skip this Ad ^_^
Mixxx is always evolving, changing and getting better... Mixxx is powered by a handful of unpaid part-time developers we've got lots of plans and we are always looking for new contributions from all places.
Some of the things in the Mixxx pipeline (many of these things are in Trunk or branches):
- Midi Script, midi input controls bound to user definable JavaScript functions [ Trunk ]
- Shoutcast support [ Trunk, currently Linux and MinGW Win32 only ]
- Real-time Sound FX processing via the LADSPA plug-in architecture [ Trunk - needs refactoring ]
- Apple iTunes Plus/M4A support [ Trunk, currently Linux only ]
- Library rewrite [ Features_sqlite branch ]
- Looping support [ planning on wiki Features_rryan-looping branch ]
- MIDI training UI to remap controls without manual editing XML files [ Trunk ]
Join us if you want to help!
- If you can code C++, then build mixxx, and send us patches
- If you can't code, join the community
forums, test Mixxx, cheer on the Mixxx dev
team or
to Mixxx.
On Feb 16, 2009 - Hercules released GPL Linux MIDI drivers for their Hercules series of DJ midi controller devices. In response to this wonderful development, the Mixxx team released an updated build of Mixxx for Linux - 1.6.1+Herc. Thanks go out to Hercules for supporting their Linux users!
Users of Hercules products on Windows and OSX will want to read the updating mapping files section to get the latest mapping files from the 1.6.1+Herc release and beyond. Mixxx 1.6.1 on non-Linux OSes can use these files.
The purpose of this document is to show how to configure Mixxx to user your Hercules device.
It also serves to show you how controls have been mapped to different or non-obvious functions in Mixxx, controls not listed here should behave as you would expect (i.e. Crossfader cross fades, Play - plays/pauses, etc). These mappings work with Hercules MIDI drivers for Linux, Mac OSX and Windows. Untested mappings are based on MIDI code documentation in the Hercules manuals and have not yet been extensively validated by the Mixxx community. These are default mappings and can be changed by editing the XML mappings (click to see how), in future versions of Mixxx we will offer a configuration screen to train/retrain/remap this controls from within Mixxx.
Bracketed numbers indicate a control's position on the control diagrams. Controller diagrams are copyright of Hercules/Guillemot corporation.
Linux NOTE: To properly make use of Mixxx via the Hercules Linux MIDI drivers you will need a release of Mixxx 1.6.1+Herc (released in Feb 2009) or higher. Previous versions of Mixxx built for Linux will work with Hercules devices via libDJConsole but can not be remapped via the XML mappings.
Linux NOTE: On Linux Mixxx version >= 1.6.1+Herc is required (1.6.1 is too old), you must also have compiled and installed the Hercules dkms kernel module into your Linux kernel
** Steps **
- Start Mixxx, open preferences panel (Ctrl+P).
- Select Input Controllers.
- Under Device find the MIDI entry for Hercules controller and select it, if it is not already selected -> If you do not see a Hercules MIDI device then the driver is not properly loaded or the devices is not plugged in.
- Choose the Controller Mapping matching your Hercules device.
Note: Both the MP3 and MK2 controllers are mapped the same way, but have different configuration files, picking the wrong config file will result in some buttons failing to perform as indicated.
| Hercules MP3/MK2 Controls | | | | | ------------------------- | --------------------- | --------------------------- | | | Control | Default Mixxx Mapping | | | | | 3 (3) | Kill High | | | | 2 (3) | Kill Mid | | | | 1 (3) | Kill Low | | | | FX/Cue/Loop (3) | Reverse | | | | Master Tempo Left | Select Prev Track in List | | | | Master Tempo Right | Select Next Track in List | | | | Left Joy Button (4) | Load selected to Left Deck | | | | Right Joy Button (4) | Load selected to Right Deck | | | | Autobeat (11) | Sync | | | | Joystick (4) | Unmapped | | | | Mic Functions | Not Available in Mixxx | |
| Hercules MK2 Controls - Mixxx 1.7 Additions | | | | | ------------------------------------------- | ----------------------------- | ----------------------------------------------------------------------------------- | | | Control | Default Mixxx Mapping | | | | | FX/Cue/Loop (3) | MIDI Script: Select mode - EQ Kill/FX/Cue/Loop | | | | FX/Cue/Loop LEDs (5) | MIDI Script: Indicates current mode - None lit (the default) indicates EQ Kill mode | | | | [EQ Kill mode] 3/2/1 (3) | MIDI Script: Kill high/mid/low | | | | [FX mode] 3/2/1 (3) | MIDI Script: Toggle flanger on/off | | | | [FX mode] 1 (3) + Pitch (2) | MIDI Script: Adjust flanger Depth | | | | [FX mode] 2 (3) + Pitch (2) | MIDI Script: Adjust flanger Delay | | | | [FX mode] 3 (3) + Pitch (2) | MIDI Script: Adjust flanger LFO | |
Note for the MK2: Although selectable, cue and loop modes are currently unsupported pending the functionality being available in Mixxx
| Hercules RMX Controls | | | | | --------------------- | --------------------- | ------------------------- | | | Control | Default Mixxx Mapping | | | | | Vol Main (25) | Master Gain | | | | 1 (9) | Flanger | | | | 4 (9) | Reverse | | | | Up (8) | Select Prev Track in List | | | | Down (8) | Select Next Track in List | | | | 2,3,5,6 (9) | Unmapped | | | | Right, Left (8) | Unmapped | | | | Stop (20) | Unmapped | | | | Pitch Reset (14) | Unmapped | | | | Beat Lock (13) | Unmapped | | | | Scratch (7) | Unmapped | | | | Mic Functions (1) | Not Available in Mixxx | |
| Hercules RMX Controls - Mixxx 1.7 Additions | | | | | ------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------- | | | Control | Default Mixxx Mapping | | | | | Scratch (7) | MIDI Script: Toggle Jog (18) Scratch/Pitch Adjust behaviour | | | | Stop (20) | MIDI Script: Stop + Reset Track to beginning | | | | Up (8)/Down (8) + Jog (18) | MIDI Script: Rapid Track List scrolling (buggy) | | | | Cue (21) + Play (19) | MIDI Script: Pushing Play while holding Cue will cause track to continue to play after Cue is released (buggy) | |
You need to update the mapping with followings files : Link to mapping
files
| Hercules DJ Control Steel Controls | | | | | ---------------------------------- | --------------------- | ------------------------- | | | Control | Default Mixxx Mapping | | | | | FX Wet/Dry Knobs (1) | Unmapped | | | | FX Apply Select (1) | Unmapped | | | | Bank Shift (2) | Unmapped | | | | Pitch Bend + (12) | Temp Rate Up | | | | Pitch Bend - (13) | Temp Rate Down | | | | Vol Main (23) | Master Gain | | | | 1 (9) | Flanger on/off | | | | 2 (9) | Hotcue 1 set | | | | 3 (9) | Hotcue 2 set | | | | 4 (9) | Reverse | | | | 5 (9) | Hotcue 1 goto | | | | 6 (9) | Hotcue 2 goto | | | | 7 (9) | loop in | | | | 8 (9) | loop exit | | | | 10 (9) | loop out | | | | 9,11,12 (9) | Unmapped | | | | Up (8) | Select Prev Track in List | | | | Down (8) | Select Next Track in List | | | | Right, Left (8) | Navigate | | | | Stop (19) | stop | | | | Scratch (7) | Unmapped | | | | Vol_HP (11) | Not Available in Mixxx | |
The most recent mapping files where included with Mixxx 1.7.0, released August 6th, 2009
<del>
- Download the appropriate controller file to the Desktop
- Open a run dialog - Win+R type "%ProgramFiles%\Mixxx\midi\" and hit Ok
- Drag the file from Desktop to "%ProgramFiles%\Mixxx\midi\" folder window
- Restart Mixxx
- Download the appropriate controller file to the Desktop
- Open Mixxx.app/Contents/Resources/midi in Finder (you can either go to your copy of Mixxx, right-click it, and click "Show Package Contents" and then navigate down, or run "open /Applications/Mixxx.app/Contents/Resources/midi").
- Drag the file from Desktop to folder window
- Restart Mixxx
Currently 1.6.1+Herc has these mapping files, however in future you can update them manually by following these steps:
- Download the appropriate controller file to the Desktop
- Open a terminal
- type "sudo cp ~/Desktop/Hercules*.xml /usr/share/mixxx/midi/"
- Restart Mixxx
</del>
This is the Mixxx Wiki - 
Mixxx is a free and open-source DJ software.
Manual
Hardware Compatibility
Reporting Bugs
Getting Involved
Contribution Guidelines
Coding Guidelines
Using Git
Developer Guide
Contributing Mappings
Mixxx Controls
MIDI Scripting
Components JS