BACK TO STUDIO
CROSSCUE DJ WORKSTATION

MIDI Mapping & Learning Guide

Comprehensive step-by-step instructions for the CREATE / EDIT workspace

Version 2.0 (EN)

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

  1. In the main CROSSCUE studio, click the MIDI button in the top toolbar.
  2. In the panel that opens on the right, click MAPPING MANAGER (top, next to CLOSE).
  3. In the top tab bar, click CREATE / EDIT.
  4. 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:

Step A: ADD ENTRYClick + ADD ENTRY. A new row will appear with default values (e.g. CH 1, CC 0).
Step B: LEARNClick LEARN on the row. It pulses with WAITING FOR MIDI INPUT... Move or press the physical control on your hardware.
Step C: ASSIGNClick ASSIGN on the same row and select which virtual function in CROSSCUE will be controlled.

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).

Modes:
  • • 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:

TEMPO / PITCH: Select PITCH A or PITCH B. Pitch orientation is auto-calibrated (up = +% faster, center = 0%).
VOLUME FADER: Select CHANNEL FADER A or CHANNEL FADER B.
CROSSFADER: Select CROSSFADER (smooth crossfade between Deck A and Deck B).
EQUALIZER (EQ): Select HIGH A/B, MID A/B, or LOW A/B.
FILTER (CFX): Select FILTER A or FILTER B.

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).

Do not assign the jog wheel manually to standard faders (like Pitch or Volume). The built-in official Pioneer DDJ-200 profile already includes native jog encoder support.

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:

CHCH: MIDI Channel (1 to 16)
TYPETYPE: CC, NOTEON, or NOTEOFF
NUMNUM: Control / Note number (0 to 127)

5How to verify that your mapping works

  1. Open MONITOR: Click MONITOR in the top-right corner of the Mapping Manager.
  2. 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).
  3. If the monitor says (no match), a message arrived from the browser, but no entry with that Channel and Number exists yet.
  4. 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

Q: PLAY button stops playback as soon as I release my finger.
A: Ensure the entry is set to NOTEON. In CROSSCUE, NoteOff events are ignored for Play so playback keeps running after releasing the button.
Q: The TEMPO fader moves in reverse direction.
A: Do not invert values manually. CROSSCUE applies the standard DJ fader orientation automatically when assigned to PITCH A or PITCH B.
Q: Controller is not detected by browser.
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.
CROSSCUE DJ Workstation · User Documentation · All rights reserved