Skip to content

MIDI Map

The MIDI Map window lists every MIDI mapping in the project and lets you change how each one behaves: its control type, encoding, range, sensitivity and more. Use it after MIDI Learn when a control doesn’t feel right.

  • Click MIDI Map in the header (the list icon next to MIDI Learn) to open the full list.
  • Or right-click any mapped control and choose Edit Mapping… to edit just that one.

The window shows the mappings on the left. Each row names the target, its MIDI source (for example CC 16 (ch any)) and its control type. Select a row to edit it on the right. Press Delete to remove the selected mapping.

Below the list:

  • Reset Defaults replaces all mappings with the default mappings.
  • Clear All removes every mapping.

Both ask you to confirm first.

The editor also has Learn Again, to learn the control afresh from your controller, and Delete, to remove the mapping. A short hint under the options explains what the current settings do.

Mappings are saved with the project. They are not part of session states, so switching states never changes your controller setup.

Only the options that apply to a mapping are enabled; the others are greyed out.

Option Range/choices Default What it does
Control Knob / fader (absolute), Encoder / jog (relative), Button: momentary, Button: toggle, Button: trigger Set by Learn How the incoming values drive the target.
Encoding Two’s complement (1 / 127), Sign-magnitude (1 / 65), Offset 64 (65 / 63) Detected by Learn How a relative encoder’s CC values say which way it turned. Relative CC mappings only.
From / To Part of the parameter’s range; for deck jog and scratch, −2 to +2 seconds Full range; ±0.25 s for decks The range the control covers.
Sensitivity 0.05x to 16x 1x Travel per encoder tick. Relative mappings only.
Takeover Jump to the control, Pick up at the current value Jump What happens when the control and the parameter disagree. Absolute mappings on parameters only.
Jog Auto (Nudge when synced), Vinyl, Nudge Auto How a jog wheel moves the deck. Relative deck jog and scratch only.
ticks per revolution 16 to 4096 /rev 128 Your jog wheel’s resolution. Relative deck jog and scratch only.
Invert On / off Off Reverses the control’s direction.
Anchor at grab On / off On Absolute deck jog and scratch only; see below.
  • Knob / fader (absolute): the control’s position maps onto the From / To range. For a deck’s jog or scratch, that’s a position in seconds around the cue point. For a deck’s touch, values above the middle count as touching.
  • Encoder / jog (relative): each tick steps the value. On a parameter, 128 ticks sweep the whole range at sensitivity 1 (a choice control moves one step every two ticks). On a deck, one full turn of the wheel moves the record 1.8 seconds.
  • Button: momentary: pressed sets To, released sets From. On a deck, the hand is on the record while the button is held.
  • Button: toggle: each press flips between From and To, or puts the hand on and off the record.
  • Button: trigger: each press steps to the next value and wraps around. For Capture, session slots, rack banks and commands, each press fires once.

Relative encoders don’t all speak the same language. If an encoder only moves one way, or jumps in big steps, try another encoding. See Jog wheels for more.

For parameters, From / To is part of the parameter’s range, shown in its own units. Narrow it to give a knob finer control over a small area, or swap the two (or use Invert) to reverse it.

For a deck’s jog or scratch, it is seconds either side of the cue point. The default ±0.25 s means a fader sweeps half a second of sample, which gives fine, controllable scratches. A smaller range gives finer scratches still.

How far one encoder tick moves. At 1x, one tick nudges a record about 14 ms, and 128 ticks sweep a parameter’s range.

  • Jump to the control follows the hardware immediately. This is what learned knobs use.
  • Pick up at the current value ignores the control until it comes within reach of the parameter’s current value (or passes it), then takes over. If automation or the mouse moves the parameter afterwards, the control lets go again until it is picked up. Use this so nothing jumps when a knob’s physical position doesn’t match the screen.

Reverses the control: a fader pushed up acts as if pulled down, an encoder turned clockwise acts as if turned back.

For a fader, knob or pitch wheel mapped to a deck’s jog or scratch, on by default:

  • On: grabbing the record with the control starts from wherever the record is, and the control moves it from there. Nothing jumps when you start.
  • Off: the record jumps to the control’s position in the From / To range, measured from the cue point.

These apply to relative mappings on a deck. Vinyl grabs the record like a hand; Nudge shifts a running deck’s timing like a CDJ’s pitch bend; Auto nudges while the deck’s Sync Loop is on and its motor runs, and acts as Vinyl otherwise. Set ticks per revolution to the number of ticks your wheel sends per turn, so one turn of the wheel turns the record once. See Jog wheels.