MIDI Mapping & Learning Guide
Comprehensive step-by-step instructions for the CREATE / EDIT workspace
Supports Pioneer DDJ-200 and standard MIDI controllers
Before you begin:
Ensure your controller is connected via USB cable or Bluetooth before opening the studio. The MIDI button in the top toolbar should glow gold with status READY or ACTIVE.
1How to access the CREATE / EDIT workspace
- In the main CROSSCUE studio, click the MIDI button in the top toolbar.
- In the panel that opens on the right, click MAPPING MANAGER (top, next to CLOSE).
- In the top tab bar, click CREATE / EDIT.
- To edit an existing profile (such as Pioneer DDJ-200): open the LIBRARY tab first, locate the profile, and click EDIT or CLONE. It will immediately load into the CREATE / EDIT editor.
2Core procedure to map a new control
Each row in the table represents a single MIDI binding. The procedure always follows 3 steps:
3Specifics per hardware control type
A. BUTTONS (Play/Pause, Cue, Sync, Loop, HotCue 1-8)
• How to press: Click LEARN, then press and release the physical button once firmly and smoothly.
• What the system captures: CROSSCUE captures NOTEON (channel and note number, e.g. CH 1, NOTEON 11 for Deck A Play).
- • PLAY / SYNC / LOOP / REPLAY work in toggle mode (toggling play/stop state on each press).
- • CUE functions in momentary mode: holding jumps to cue point, releasing pauses, exactly like Pioneer hardware players.
- • HOT CUE triggers an instant jump to the saved cue marker.
B. FADERS AND POTENTIOMETERS (Tempo/Pitch, Channel Faders, Crossfader, EQ, Filter)
• How to move: Click LEARN and move the physical slider or knob across at least half of its travel.
• What the system captures: A CC (Continuous Controller) message is recorded in continuous mode.
Essential target assignments:
C. JOG WHEELS (Jog Dial / Scratch / Pitch Bend)
Jog wheels on controllers like Pioneer DDJ-200 do not send an absolute 0-127 position, but relative tick pulses for rotation direction and velocity (CC 33 / CC 34).
4Manual parameter input (without moving hardware)
If a control is hard to trigger or you want to fix an entry manually, use the three input fields on each row:
5How to verify that your mapping works
- Open MONITOR: Click MONITOR in the top-right corner of the Mapping Manager.
- Move or press the control. The monitor displays the incoming message and the target action in green (e.g. CH 1 CC 32 → PITCH A).
- If the monitor says (no match), a message arrived from the browser, but no entry with that Channel and Number exists yet.
- Save your profile: Click SAVE PROFILE at the bottom. The profile is saved in browser storage and stays active across sessions.
Configuring Unfamiliar and Vintage DJ Mixers & Consoles
How to map any arbitrary MIDI hardware (Hercules, Numark, Reloop, Denon, Akai, Behringer, Korg, etc.) step-by-step
1. Device Identification & Plug-and-Play Connection
Most modern and classic USB DJ mixers are class-compliant (they communicate via standard MIDI without manufacturer drivers in Web MIDI browsers). Connect the hardware with a USB cable or USB-MIDI adapter. Open Mapping Manager and verify that the device name appears in the top DEVICES bar.
2. Signal Discovery via the MIDI MONITOR
Before creating entries, click MONITOR in the top right. Move or press each hardware control on your unknown mixer. The monitor displays real-time input: channel (CH 1–16), type (CC or NOTEON), and control number (0–127). This reveals the full hardware signal layout of your console.
3. Intelligent Auto-Detection (AUTO-DETECT) or Manual Profile
In Mapping Manager, select the "⚡ AUTO-DETECT" tab. Move controls on your unknown mixer: CrossCue automatically analyzes signal signatures (faders, EQ knobs, buttons, jog rotation), suggests matching DJ functions with confidence ratings, and lets you confirm and save directly into My Mappings or export to JSON.
4. Handling Dual 14-bit or Relative Encoders
Certain hardware consoles transmit pitch faders across two linked CC numbers (MSB/LSB for 14-bit resolution) or endless knobs as relative increments. When two messages trigger simultaneously on a fader movement, bind the primary CC number (usually the lower value).
5. Saving, Testing & Profile Export (EXPORT JSON)
Once your essential controls are mapped and tested with audio, click SAVE PROFILE. You can then click EXPORT PROFILE to download the complete mapping configuration as a portable JSON file for backup or community sharing.
Troubleshooting & Common Questions
A: Ensure the entry is set to NOTEON. In CROSSCUE, NoteOff events are ignored for Play so playback keeps running after releasing the button.
A: Do not invert values manually. CROSSCUE applies the standard DJ fader orientation automatically when assigned to PITCH A or PITCH B.
A: Use Google Chrome, Microsoft Edge, Opera, or Brave with Web MIDI enabled. Allow the "Allow MIDI devices" prompt in the URL bar when prompted.