User Tools

Site Tools


hercules_dj_control_mp3_e2

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
hercules_dj_control_mp3_e2 [2016/04/28 17:34]
be.ing [Hercules DJ Control MP3 e2]
hercules_dj_control_mp3_e2 [2017/11/25 16:22] (current)
josepma Some clarifications about the linux driver
Line 1: Line 1:
-====== Hercules DJ Control MP3 e2 ======+====== Hercules DJ Control MP3 e2 / MP3 LE / Glow ====== 
 +MP3 e2
  
 +{{:​16445_.jpg}}
  
-{{ :​16445_.jpg?​nolink&​ |}}+MP3 LE
  
 +{{:​hardware:​hercules-dj-control-mp3-le.jpeg?​600x419}}
  
 +Glow
  
-The Hercules DJ Control MP3 e2 is a USB controllerThe controller does not have a built in sound card, so a [[hardware compatibility#​splitter cables|splitter cable]] or [[hardware compatibility#​USB sound cards|separate sound card]] is recommended for use with it. The DJ Control MP3 e2 is not class compliant MIDI device and works in Mixxx as a USB bulk data controller. [[Hercules DJ Control MP3 e2 old|Older versions of Mixxx]] required using Hercules'​ MIDI driver, but it is now recommend ​to not use the Hercules driverwhether you use WindowsMac OS X, or GNU/LinuxIf you have it installed, it is recommended ​to uninstall ​the driver ​and upgrade to the [[http://​mixxx.org/​download|latest version of Mixxx]] if you have not already.+{{:​hardware:​hercules-dj-control-glow.jpeg}} 
 + 
 + 
 +The Hercules DJ Control MP3 e2, MP3 LE, and Glow are USB controllers that have identical controls and share the same mappingThese controllers do not have a built in sound card, so a [[hardware compatibility#​splitter cables|splitter cable]] or [[hardware compatibility#​USB sound cards|separate sound card]] is recommended for use with it. They are not class compliant MIDI devices. [[Hercules DJ Control MP3 e2 old|Older versions of Mixxx]] required using [[hercules_linux_kernel_module|Hercules'​ MIDI driver]], but this driver can be a hassle ​to set up and maintain on Linuxso it is recommended only for Windows ​and Mac OS X. Another alternative ​is to use the [[hercules_linux_usermode_driver|user mode driver]], or also upgrade to the [[http://​mixxx.org/​download|latest version of Mixxx]] if you have not already. Support for using the MP3 LE and Glow as USB Bulk controllers without the driver on Linux is available in development versions of Mixxx and will be included in Mixxx 2.1, but the MP3 e2 was already supported in Mixxx 2.0.
  
 The mapping is included in Mixxx and allows you to manipulate 4 decks, 2 at a time, switching Deck A (left) between Channel 1 and 3 and Deck B (right) between Channel 2 and 4. The mapping is included in Mixxx and allows you to manipulate 4 decks, 2 at a time, switching Deck A (left) between Channel 1 and 3 and Deck B (right) between Channel 2 and 4.
Line 14: Line 21:
 ===Shift / Supershift ​ === ===Shift / Supershift ​ ===
 {{ ::​hercules-mp3e2-schema-shift.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-shift.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                                                                                                                    ​^ Control ​             ^ number ​ ^ 
-| Shift button to obtain more controls than those provided by Hercules. \\ Press & Hold automix, then press corresponding button to obtain shifted behavior. | Automix ^  | +| Shift button to obtain more controls than those provided by Hercules. \\ Press & Hold automix, then press corresponding button to obtain shifted behavior. ​                  ​| Automix ​                   ​^ 
-| Supershift button to obtain a third level of controls. \\ Press & Hold Automix, then press & Hold Scratch, then press corresponding button to obtain supershifted behavior. | Shift-Scratch ^  | +| Supershift button to obtain a third level of controls. \\ Press & Hold Automix, then press & Hold Scratch, then press corresponding button to obtain supershifted behavior. ​ | Shift-Scratch ​             ​^ 
-| Switch deck A (left) between Channel1 and Channel3 (also apply to Sampler1 and Sampler3) | Supershift + Load A  ​18 ​| +| Switch deck A (left) between Channel1 and Channel3 (also apply to Sampler1 and Sampler3) ​                                                                                    ​| Supershift + Load A  ​^      ​18 ^ 
-| Switch deck B (right) between Channel2 and Channel4 (also apply to Sampler2 and Sampler4) | Supershift + Load B  ​18 ​|+| Switch deck B (right) between Channel2 and Channel4 (also apply to Sampler2 and Sampler4) ​                                                                                   | Supershift + Load B  ​^      ​18 ^
  
 ===Library=== ===Library===
 {{ ::​hercules-mp3e2-schema-library.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-library.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                    ​^ Control ​                       ^ number ​ ^ 
-| Select prev/next playlist | Supershift + Deck A Jog Wheel  ​16 ​| +| Select prev/next playlist ​                                                   | Supershift + Deck A Jog Wheel  ​^      ​16 ^ 
-| Toggles (expands/​collapses) the currently selected library sidebar item | Folder ^  | +| Toggles (expands/​collapses) the currently selected library sidebar item      | Folder ​                        ​      ​^ 
-| Go one track down | Up arrow ^  | +| Go one track down                                                            | Up arrow                       ​      ​^ 
-| Go one track up | Shift + Up arrow ^  | +| Go one track up                                                              | Shift + Up arrow               ​      ​^ 
-| Select prev/next track | Supershift + Deck B Jog Wheel  16| +| Select prev/next track                                                       ​| Supershift + Deck B Jog Wheel  ​^      ​16 ^ 
-| Loads the currently highlighted track into the corresponding deck (A or B) | Load A/B ^  18 | +| Loads the currently highlighted track into the corresponding deck (A or B)   ​| Load A/B                       ​     18 ^ 
-| Loads the current highlighted track into the corresponding sampler (1 or 2) | Shift + Load A/B ^  18 |+| Loads the current highlighted track into the corresponding sampler (1 or 2)  | Shift + Load A/B               ​     18 ^
  
 ===Master/​Headphones/​Microphone ​ === ===Master/​Headphones/​Microphone ​ ===
 {{ ::​hercules-mp3e2-schema-masterheadmicro.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-masterheadmicro.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                          ​^ Control ​                   ^ number ​ ^ 
-| Microphone TalkOver | Down Arrow ^  | +| Microphone TalkOver ​                                               | Down Arrow                 ​      ​^ 
-| Fades between left (channel 1 & 3) and right (channel 2 & 4) deck | Crossfader ^  19 | +| Fades between left (channel 1 & 3) and right (channel 2 & 4) deck  | Crossfader ​                ​     19 ^ 
-| Headphone volume | Shift + Deck A pitch knob  ​3 ​| +| Headphone volume ​                                                  ​| Shift + Deck A pitch knob  ​^       ^ 
-| Adjust the cue/main mix in the headphone output | Shift + Deck B pitch knob  ​3 ​| +| Adjust the cue/main mix in the headphone output ​                   | Shift + Deck B pitch knob  ​^       ^ 
-| Toggles deck output to the headphones monitor on/off | Headphone monitor ^  20 |+| Toggles deck output to the headphones monitor on/​off ​              ​| Headphone monitor ​              20 ^
  
 ===Sampler ​ === ===Sampler ​ ===
 {{ ::​hercules-mp3e2-schema-sampler.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-sampler.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                    ​^ Control ​             ^ number ​ ^ 
-| Loads the current highlighted track into the corresponding sampler (1 or 2) | Shift + Load A/B ^  18 | +| Loads the current highlighted track into the corresponding sampler (1 or 2)  | Shift + Load A/B     ​     18 ^ 
-| Goto start & Play sampler 1/3 | Shift + Folder ^  | +| Goto start & Play sampler 1/3                                                | Shift + Folder ​      ​      ​^ 
-| Stop sampler 1/3 | Supershift + Folder ​ ​6 ​| +| Stop sampler 1/3                                                             ​| Supershift + Folder  ​^       ^ 
-| Goto start & Play sampler 2/4 | Shift + Files ^  10 | +| Goto start & Play sampler 2/4                                                | Shift + Files             10 ^ 
-| Stop sampler 2/4 | Supershift + Files ^  10 |+| Stop sampler 2/4                                                             ​| Supershift + Files   ​     10 ^
  
 ===Decks / Channels ​ === ===Decks / Channels ​ ===
Line 53: Line 60:
 ==Playing ​ == ==Playing ​ ==
 {{ ::​hercules-mp3e2-schema-deck-playing.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-deck-playing.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                                                                                                                                                                                    ​^ Control ​            ​^ number ​ ^ 
-| Loads the currently highlighted track into the corresponding deck (A or B) | Load A/B ^  18 | +| Loads the currently highlighted track into the corresponding deck (A or B)                                                                                                                                                                   ​| Load A/B                 18 ^ 
-| Starts or stop a loaded track | Play ^  14 | +| Starts or stop a loaded track                                                                                                                                                                                                                | Play                     14 ^ 
-| Backward Play | Shift + Play ^  14 | +| Backward Play                                                                                                                                                                                                                                | Shift + Play             14 ^ 
-| Toggle Repeat | Supershift + Play ^  14 | +| Toggle Repeat ​                                                                                                                                                                                                                               | Supershift + Play   ​     14 ^ 
-| Sets the cue point if a track is stopped 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 | Cue ^  15 | +| Sets the cue point if a track is stopped 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  | Cue                 ​     15 ^ 
-| Move Forward/​Backward in track | Forward / Backward ​ ​12 ​| +| Move Forward/​Backward in track                                                                                                                                                                                                               ​| Forward / Backward  ​^      ​12 ^ 
-| Enable or disable the scratch mode on all four decks | Scratch ^  | +| Enable or disable the scratch mode on all four decks                                                                                                                                                                                         ​| Scratch ​            ​      ​^ 
-| 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 scratch mode enabled | Jog wheel ^  16 |+| 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 scratch mode enabled ​                                                ​| Jog wheel           ​     16 ^
  
 ==Volume / Equalizer / Effects ​ == ==Volume / Equalizer / Effects ​ ==
 {{ ::​hercules-mp3e2-schema-deck-voleffects.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-deck-voleffects.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                    ​^ Control ​                                  ​^ number ​ ^ 
-| Controls the deck output volume, with soft takeover on deck switch. | Deck volume slider ^  17 | +| Controls the deck output volume, with soft takeover on deck switch. ​         | Deck volume slider ​                            17 ^ 
-| Adjusts the gain of the low/​medium/​high equalizer filter. No soft takeover. | Equalizer knobs ^  | +| Adjusts the gain of the low/​medium/​high equalizer filter. No soft takeover. ​ | Equalizer knobs                           ​      ​^ 
-| Filter Low Kill | Supershift + Pitchbend - ^  | +| Filter Low Kill                                                              | Supershift + Pitchbend -                        ​^ 
-| Filter Mid Kill | Supershift + Sync ^  13 | +| Filter Mid Kill                                                              | Supershift + Sync                         ​     13 ^ 
-| Filter High Kill | Supershift + Pitchbend + ^  | +| Filter High Kill                                                             ​| Supershift + Pitchbend +                        ​^ 
-| Adjust pregain | Shift + Forward / Backward ^  12 | +| Adjust pregain ​                                                              ​| Shift + Forward / Backward ​                    12 ^ 
-| Quick Filter knob | Supershift + Pitch knobs ^  | +| Quick Filter knob                                                            | Supershift + Pitch knobs                        ​^ 
-| Brake Effect | Supershift + Forward (stops on release) ^  12 | +| Brake Effect ​                                                                ​| Supershift + Forward (stops on release) ​  ​     12 ^ 
-| Spinback Effect | Supershift + Backward (stops on release) ​ ​12 ​|+| Spinback Effect ​                                                             | Supershift + Backward (stops on release)  ​^      ​12 ^
  
  
Line 82: Line 89:
 //Need to be in Hotcue mode (button Loop/Fx (4) lit up). If not, press Loop/Fx button to switch to hotcue mode.// //Need to be in Hotcue mode (button Loop/Fx (4) lit up). If not, press Loop/Fx button to switch to hotcue mode.//
  
-^ Function ^ Control ​ ^ number ​| +^ Function ​                                                                                                                         ^ Control ​                 ^ number ​ ^ 
-| 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. | 1/2/3/4 buttons ^  11 | +| 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. ​ | 1/2/3/4 buttons ​              11 ^ 
-| If hotcue X is set, clears its hotcue status. | Shift + 1/2/3/4 buttons ​ ​11 ​|+| If hotcue X is set, clears its hotcue status. ​                                                                                    ​| Shift + 1/2/3/4 buttons  ​^      ​11 ^
 \\ \\
 \\ \\
Line 94: Line 101:
 //Need to be in Loop mode (button Loop/Fx (4) turned off). If not, press Loop/Fx button to switch to Loop mode.// //Need to be in Loop mode (button Loop/Fx (4) turned off). If not, press Loop/Fx button to switch to Loop mode.//
  
-^ Function ^ Control ​ ^ number | +^ Function ​                       ^ Control ​               ^ number ​ ^ 
-| loop-in | Button 1 ^  11 | +| loop-in ​                        ​| Button 1               ​     11 ^ 
-| loop-out | Button 2 ^  11 | +| loop-out ​                       | Button 2               ​     11 ^ 
-| Toggles current loop On or Off | Button 3 ^  11 | +| Toggles current loop On or Off  | Button 3               ​     11 ^ 
-| Clear Loop | Supershift + Button 1  ​11 ​| +| Clear Loop                      | Supershift + Button 1  ​^      ​11 ^ 
-| loop 1/8 | Supershift + Button 2  ​11 ​| +| loop 1/8                        | Supershift + Button 2  ​^      ​11 ^ 
-| loop 1/4 | Shift + Button 1 ^  11 | +| loop 1/4                        | Shift + Button 1       ​     11 ^ 
-| loop 1/2 | Shift + Button 2 ^  11 | +| loop 1/2                        | Shift + Button 2       ​     11 ^ 
-| loop 1 | Shift + Button 3 ^  11 | +| loop 1                          | Shift + Button 3       ​     11 ^ 
-| loop 2 | Shift + Button 4 ^  11 | +| loop 2                          | Shift + Button 4       ​     11 ^ 
-| loop 4 | Button 4 ^  11 | +| loop 4                          | Button 4               ​     11 ^ 
-| loop 8 | Supershift + Button 3  ​11 ​| +| loop 8                          | Supershift + Button 3  ​^      ​11 ^ 
-| loop 16 | Supershift + Button 4  ​11 ​| +| loop 16                         ​| Supershift + Button 4  ​^      ​11 ^ 
-| Double loop | Shift + Pitchbend + ^  | +| Double loop                     ​| Shift + Pitchbend +          ​^ 
-| Half loop | Shift + Pitchbend - ^  |+| Half loop                       ​| Shift + Pitchbend -          ​^
  
  
 ==Pitch / Syncing ​ == ==Pitch / Syncing ​ ==
 {{ ::​hercules-mp3e2-schema-pitchsync.jpg?​direct&​400|}} {{ ::​hercules-mp3e2-schema-pitchsync.jpg?​direct&​400|}}
-^ Function ^ Control ​ ^ number | +^ Function ​                                                                                                                                                                                    ​^ Control ​                   ^ number ​ ^ 
-| Temporary Holds the pitch 4% higher while pressed | Pitchbend +/- ^  | +| Temporary Holds the pitch 4% higher while pressed ​                                                                                                                                           | Pitchbend +/-                    ​^ 
-| Set deck as master clock. \\ Led blink: master \\ Fixed led: Follower \\  Led off: none | Master tempo ^  | +| Set deck as master clock. \\ Led blink: master \\ Fixed led: Follower \\  Led off: none                                                                                                      | Master tempo (MP3 e2) / Pitch reset (MP3 LE & Glow)                     ​^ 
-| Adjust playback pitch / speed | Pitch knobs ^  | +| Adjust playback pitch / speed                                                                                                                                                                | Pitch knobs                      ​^ 
-| Automatically sets pitch so the BPM of the other deck is matched | Sync ^  13 | +| Automatically sets pitch so the BPM of the other deck is matched ​                                                                                                                            ​| Sync                       ​     13 ^ 
-| Enable key-lock for the specified deck (rate changes only affect tempo, not key) | Shift + Master tempo ^  | +| Enable key-lock for the specified deck (rate changes only affect tempo, not key)                                                                                                             ​| Shift + Master tempo       ​      ​^ 
-| Magnet (all cues, hotcues, loops, and beatloops will be automatically quantized so that they begin on a beat.) | Supershift + Master tempo ^  | +| Magnet (all cues, hotcues, loops, and beatloops will be automatically quantized so that they begin on a beat.) ​                                                                              ​| Supershift + Master tempo        ​^ 
-| Adjust beatgrid | Shift + Sync ^  13 | +| Adjust beatgrid ​                                                                                                                                                                             | Shift + Sync               ​     13 ^ 
-| Enable or disable the scratch mode on all four decks | scratch ^  | +| Enable or disable the scratch mode on all four decks                                                                                                                                         ​| scratch ​                         ​^ 
-| 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 scratch mode enabled | Jog wheel ^  16 |+| 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 scratch mode enabled ​ | Jog wheel                       16 ^
  
 ===== Mapping description (by knob/​button) ===== ===== Mapping description (by knob/​button) =====
Line 128: Line 135:
  
 ===Global controls ​ === ===Global controls ​ ===
-^ Number ^ Control ​ ^ Function ^ shifted ^ Supershifted ​| +^ Number ​ ^ Control ​       ^ Function ​                                                                                                                                                                 ^ shifted ​                                                                                                                                                                                  ​^ Supershifted ​                                              ^ 
-^ 8  | Arrow up/down | Up : goes one track down \\ Down : Microphone TalkOver | Up : Goes one track up \\ Down : Nothing | Nothing | +^ 8       ​| Arrow up/​down ​ | Up : goes one track down \\ Down : Microphone TalkOver ​                                                                                                                   | Up : Goes one track up \\ Down : Nothing ​                                                                                                                                                 | Nothing ​                                                   
-^ 6  | Folder | Toggles (expands/​collapses) the currently selected library sidebar item | Play/​Stutter sampler 1/3 | Stop sampler 1/3 | +^ 6       ​| Folder ​        ​| Toggles (expands/​collapses) the currently selected library sidebar item                                                                                                   ​| Play/​Stutter sampler 1/3                                                                                                                                                                  | Stop sampler 1/3                                           ​
-^ 10 | Files  | Toggles (expands/​collapses) the currently selected library sidebar item | Play/​Stutter sampler 2/4 | Stop sampler 2/4 | +^ 10      | Files          | Toggles (expands/​collapses) the currently selected library sidebar item                                                                                                   ​| Play/​Stutter sampler 2/4                                                                                                                                                                  | Stop sampler 2/4                                           ​
-^ 18 | Load A/B| Loads the currently highlighted track into the corresponding deck (A or B) | Loads the current highlighted track into the corresponding sampler (1 or 2) | Switch deckA between Channel 1 & 3 and deckB between 2 &4 | +^ 18      | Load A/B       ​| Loads the currently highlighted track into the corresponding deck (A or B)                                                                                                | Loads the current highlighted track into the corresponding sampler (1 or 2)                                                                                                               ​| Switch deckA between Channel 1 & 3 and deckB between 2 &​4 ​ 
-^ 19 | Crossfader | Fades between left (channel 1 & 3) and right (channel 2 & 4) deck  ||| +^ 19      | Crossfader ​    ​| Fades between left (channel 1 & 3) and right (channel 2 & 4) deck                                                                                                                                                                                                                                                                                                                                                                ||| 
-^ 9  | Automix | Used as a master shift button to obtain more controls than those provided by Hercules. Press & Hold automix, then press corresponding button to obtain shifted behavior. |||  +^ 9       ​| Automix ​       | Used as a master shift button to obtain more controls than those provided by Hercules. Press & Hold automix, then press corresponding button to obtain shifted behavior. ​                                                                                                                                                                                                                                                        ​||| 
-^ 7  | Scratch | Enable or disable the scratch mode on both decks | Used as a master supershift button to obtain a third level of controls. Press & Hold Automix, then press & Hold Scratch, then press corresponding button to obtain supershifted behavior ||+^ 7       ​| Scratch ​       | Enable or disable the scratch mode on both decks                                                                                                                          | Used as a master supershift button to obtain a third level of controls. Press & Hold Automix, then press & Hold Scratch, then press corresponding button to obtain supershifted behavior ​                                                             ||
  
 ===Deck / Channel specific controls === ===Deck / Channel specific controls ===
Line 171: Line 178:
 It has been reported that when the Hercules drivers are installed on a Windows, the driver takes over the bulk communication with the controller so it cannot be recognized by Mixxx as a bulk controller. Uninstall the Hercules driver and use it as a USB bulk controller. It has been reported that when the Hercules drivers are installed on a Windows, the driver takes over the bulk communication with the controller so it cannot be recognized by Mixxx as a bulk controller. Uninstall the Hercules driver and use it as a USB bulk controller.
 ===== Mapping files ===== ===== Mapping files =====
-This mapping ​consist ​of 4 files:+This mapping ​consists ​of 4 files:
   * ''​Hercules DJ Control MP3 e2.midi.xml'':​ MIDI XML mapping file   * ''​Hercules DJ Control MP3 e2.midi.xml'':​ MIDI XML mapping file
   * ''​Hercules DJ Control MP3 e2-scripts.js'':​ The main script, used directly by the MIDI XML mapping and by the USB bulk compatibility script.   * ''​Hercules DJ Control MP3 e2-scripts.js'':​ The main script, used directly by the MIDI XML mapping and by the USB bulk compatibility script.
   * ''​Hercules DJ Control MP3 e2.bulk.xml'':​ The USB bulk XML mapping file. Tells Mixxx to pass all incoming data to the MP3e2.incomingData function in the bulk compatibility script.   * ''​Hercules DJ Control MP3 e2.bulk.xml'':​ The USB bulk XML mapping file. Tells Mixxx to pass all incoming data to the MP3e2.incomingData function in the bulk compatibility script.
   * ''​Hercules-mp3e2-compat.js'':​ The USB bulk controller script that reads incoming data and calls the appropriate function in ''​Hercules DJ Control MP3 e2-scripts.js''​   * ''​Hercules-mp3e2-compat.js'':​ The USB bulk controller script that reads incoming data and calls the appropriate function in ''​Hercules DJ Control MP3 e2-scripts.js''​
hercules_dj_control_mp3_e2.1461879260.txt.gz · Last modified: 2016/04/28 17:34 by be.ing