Skip to main content
Advanced engineering
Deckmatics Academy article cover: What MIDI Mapping Is and What You Can Actually Change on a DJ Controller
Credits: Deckmatics

Deckmatics

Deckmatics vector SVG generated on this page.

Deckmatics Academy article cover: What MIDI Mapping Is and What You Can Actually Change on a DJ Controller
MIDI mapping, mods and homebrew · Beginner · 6 min read

What MIDI Mapping Is and What You Can Actually Change on a DJ Controller

MIDI mapping connects your controller's controls to software functions. Learn what you can really change, what you cannot, and why.

A mapping does not “improve” your controller: it decides what each button does. It is a translation layer between two worlds unfamiliar with each other: hardware sending messages and software with a list of functions it accepts. If a function is absent from that list, no mapping can invent it.

This guide opens the topic. The goal is to predict what you can and cannot change on your equipment, rather than memorise numbers, so you stop losing afternoons trying impossible things.

What MIDI is and what “mapping” really means

MIDI (Musical Instrument Digital Interface) does not carry sound. It carries instructions: “this key was pressed”, “this knob moved to this value”. Audio follows a separate path through your controller’s converter.

The significant, reassuring consequence: a mapping cannot damage your equipment’s sound, because it never touches audio. It only decides which software function is triggered when you move something.

Mapping therefore means constructing a two-column equivalence table:

  • What the hardware sends when you move a control.
  • The software function you want to respond to that message.

Almost all misunderstandings confuse those columns. The manufacturer determines the first, software determines the second, and you can only pair them.

The four messages you will see repeatedly

The standard’s official table defines control messages, but in a booth you will almost always encounter the same four.

Note On and Note Off

These are on/off messages. A pad or button sends “note X on” when pressed and “note X off” when released. When software lets you assign something to a button, you are almost always assigning a note.

Control Change (CC)

This is a continuous message. A knob or fader sends “control number Y with value Z”. The standard’s table lists defined control numbers, with values from 0 to 127. Use it for volume, filter, gain or any parameter with a position.

Pitch Bend

This is the pitch wheel. It has its own message because it needs far more resolution than ordinary CC: 128 steps are insufficient for fine tempo adjustment.

Program Change

Changes a program or preset. It is rarely mapped in a booth, but appears on equipment switching sound banks.

The three MIDI limits explaining almost every problem

The MIDI channel

Each message travels on one of 16 channels. If your controller sends on channel 3 and software listens on 1, nothing happens and the control appears broken. This is configuration rather than hardware failure.

7 bits: 128 steps

A CC value has 128 possible positions. This is ample for volume or a filter, but insufficient for precise tempo tuning, so manufacturers use Pitch Bend or combine two messages. When a control “jumps” or lacks the detail you want, this limit is often responsible.

Software only listens to what it exposes

This is the guide’s key point. Software publishes a list of assignable functions. Anything absent cannot be mapped, however perfect the hardware message. The list changes across programs and versions, so the same controller can offer much more in one program than another.

MIDI Learn: what it does and does not do

MIDI Learn is the shortcut. Enable learning mode, select the software function and move the physical control: software hears the incoming message and assigns it.

It helps you:

  • Quickly pair a control you already know works.
  • Recover a lost mapping.
  • Assign a single control without knowing its control number.

It does not:

  • Create a function absent from the software.
  • Control two things at once with a single control, unless software has layers.
  • Make an LED respond: output assignments are separate.

Why a button can send MIDI yet be impossible to remap

There are four typical reasons, only one attributable to your configuration:

  1. The message arrives, but the function does not exist. Software has no such action, leaving nothing to assign.
  2. The control does not speak MIDI. It uses HID or a proprietary protocol. A MIDI monitor will not show it because it is not sending MIDI.
  3. Software locks it. Some programs allow free reassignment; others lock functions they consider critical.
  4. The channel or port does not match. This is the only case truly fixable through configuration.

Distinguishing case 1 from case 2 avoids the most common mistake: insisting on mapping something that will never appear in the list.

What you can and cannot change on a controller

The table brings the above together: only the first two paths work with ordinary mapping. When a control resists, check which path it uses before blaming mapping.

A surprising detail: a working button does not imply a responding LED. These are separate assignments, one input and one output. A perfect mapping with unlit lights is common; the output part is missing rather than the mapping faulty.

Control paths in a DJ controller
Control path What it is Can software remap it? Is a mod needed?
Control Change (CC) Continuous 7-bit message (0-127). Typical for knobs, faders and many pads.Yes, if the software function existsNo
Note On / Note Off On/off message. Typical for pads and buttons.Yes, if the software function existsNo
HID Human interface device protocol. Not MIDI; invisible to a MIDI monitor.Depends on software and modelUsually not, but some software supports it natively
Manufacturer protocol Proprietary equipment dialect (for example, controls and screens communicating with official software).RarelyNot a mod, but outside mapping
SysEx Manufacturer-specific messages outside the general control standard.Almost neverOutside mapping's scope

Only the first two rows are handled by normal mapping. The others explain why some controls never appear in the assignable list.

Checking whether your controller is mappable

Before changing anything, perform a two-minute check:

  1. See whether it appears as a MIDI device. If software lists it as MIDI, there is scope. Recognising only a specific model may mean HID or its proprietary protocol.
  2. Check the input port. In software with a controller manager, each mapping has input and output ports. If set to “none”, the mapping exists but is inactive.
  3. Move a control and observe. If nothing lights in the assignment screen, that control is not sending what software expects.
  4. Check the assignable-functions list. This is the actual boundary of what you can achieve. Anything absent does not exist for your mapping.

What MIDI mapping is NOT

Distinguish these concepts from the start, because confusing them causes most misinformation on the topic:

  • HID is not MIDI. It is another control path with greater resolution and access to elements MIDI does not cover.
  • A mod or custom firmware is not mapping. Changing firmware intervenes in equipment; mapping is a software setting.
  • A script or middleware is not mapping either. It is an extra layer translating messages when software cannot do so itself.
  • USB is not a control protocol. It is the cable carrying MIDI, HID or something else.

Maintaining that distinction tells you which territory you are in and what to expect from each solution.

Common mistakes

  • Looking for the wrong function. In software B, you try to assign something existing only in software A.
  • Ignoring the MIDI channel. The control sends correctly, but on a channel nobody listens to.
  • Assuming LED support is included. It is not: LEDs need output assignments.
  • Confusing mapping with a mod. Mapping is reversible and does not touch equipment; a mod is different.
  • Reinstalling software first. A lost mapping can almost always be restored by importing or rebuilding it.

Next step

You now know what mapping means and, especially, its boundary. The natural next step is understanding why some controls do not speak MIDI at all: the difference between MIDI and HID explains cases that currently seem inexplicable.

Frequently asked questions

Does MIDI mapping change my controller's sound?

No. Mapping only decides which software function each physical control triggers. It does not process audio or change your equipment's converter.

Can I map any button on my controller?

Not always. You can only map functions the software exposes as assignable. If a function is absent from the software's list, no mapping can create it.

What is the difference between MIDI Learn and manually editing the message table?

MIDI Learn listens to the message sent when you move a control and assigns it automatically. Manual editing lets you enter the control number and channel when you already know the hardware's message.

Why does my controller not appear as a MIDI device?

It may be using HID or a manufacturer's proprietary protocol instead of standard MIDI. This is common in high-end equipment and is not a hardware fault.

Are my controller's LEDs controlled by the same mapping?

No. LED control uses output messages (MIDI OUT), assigned separately from inputs. A working button does not imply its light will respond.

Is MIDI mapping dangerous?

No. A mapping is a reversible software setting: export it, duplicate it or restore the default. Risks arise with mods and firmware, which are different things.

Continue learning

Next lessonMIDI vs HID on DJ Controllers: Why It Matters

Why two similar DJ controllers can behave differently: MIDI and HID are not the same protocol, and that affects jog wheels, displays and software support.

Sources

  1. MIDI 1.0 Control Change Messages (Data Bytes) Technical standard MIDI Association (MMA) · accessed on

    Official Control Change and Channel Mode message table. Control numbers 120–127 are reserved for Channel Mode Messages, and control values range from 0 to 127 (7 bits). Also documents Registered Parameter Numbers selected with control numbers 101 and 100 and written with Data Entry (6 MSB / 38 LSB).

  2. MIDI LEARN Operation Guide (rekordbox) Official documentation AlphaTheta / rekordbox · accessed on

    Official MIDI LEARN guide in Performance mode. Confirms that assigning controls is a documented, reversible software function, independent of modifying the equipment.

  3. How to Use the Controller Manager in Traktor Official documentation Native Instruments · accessed on

    Defines mapping as the relationship between hardware control elements and software functions. Explains that 'Mapped to' displays values as Channel.CC or Channel.Note, devices using NHL or HID show control names rather than numbers, and output assignments provide LED feedback.

  4. Mixxx User Manual 2.4 — Advanced Topics (controller mappings) Community (additional context) Mixxx (proyecto de código abierto) · accessed on

    Documents the same model from the open-source perspective: a mapping file translates controller MIDI or HID messages into commands the software understands, confirming that HID is a separate control path from MIDI.

Last technical review: 29/09/2026. Please report any errors so they can be corrected.