RUB docs

MIDI map

Learn CCs on any control, manage all assignments in one list, and save reusable .midimap presets.

RUB does not ship a fixed MIDI CC layout. You assign CCs yourself with MIDI Learn, review everything in the MIDI Map manager, and optionally save named .midimap presets that move between projects.

Open the manager

Click the MIDI icon in the lower-right chrome (next to Song JSON / Shortcuts). The manager lists every live CC assignment across inputs.

MIDI map button
MIDI map — opens the manager for CC assignments and .midimap presets.
MIDI Map manager
MIDI Map manager — filter by device, sort columns, clear rows, Save / MAP presets.

How to learn a CC

  1. Right-click a knob, LED (including ×2, COMP, panel enable LEDs, Tune sync), fader, or the BPM field.
  2. Choose MIDI Learn — a hollow ring waits for the next CC.
  3. Move a hardware control. The mapping sticks; a small orange dot marks learned controls.
  4. Right-click again → Clear (CC n) to remove that mapping, or clear rows from the manager.
MIDI Learn menu
Control menu — Add to Param Seq, MIDI Learn, and Clear for a mapped CC. Use the MIDI icon for the full manager.

Sequenceable controls also offer Add to Param Seq in the same menu.

Filter, sort, clear

  • DEVICE — show all inputs, or one controller. Standalone keeps a separate map per MIDI input; the plugin host uses a single Host device.
  • Column headers — sort by Device, CC, or Parameter.
  • Row × — clear one assignment.
  • Clear — wipe live assignments in the current filter (does not delete saved MAP presets).
Device filter
DEVICE filter — All devices, or one MIDI input (per-controller maps in standalone).

Same CC number on two devices can target different parameters without clobbering each other.

MAP presets (.midimap)

Save writes the full multi-device map as a named preset under Application Support (RUB/MidiMaps/*.midimap). Pick a row from MAP to load; hover a row to delete it.

MAP picker
MAP picker — load a saved .midimap; hover a row to delete.

Maps are independent of song presets — load a controller layout, then switch .rub songs freely.

What can be learned

Everything in the Parameters catalog that appears as a panel control — plus UI-only bits like play and note capture where exposed. Sequenceable params can still be MIDI-mapped for live performance while Param Seq writes steps.

Typical targets:

  • Filter, Rub, Delay, Dist, Master, Comp
  • Osc Mix, types, ×2, Tune A/B, Range, sync
  • BPM (also clocks delay in SYNC)
  • Lane Blend when Param Seq is active

Persistence

  • Live map — saved with host / standalone state (multi-device v2 text, or legacy cc=paramId;…).
  • Named presets — .midimap files via Save / MAP.
  • Moving a project keeps the live map if the plugin state travels with it.

Tips

  • Learn from a quiet CC lane so the next message isn’t an accidental mod wheel bump.
  • For Param Seq workflows, map the panel knob and sequence the same id_str — Blend decides how much of each you hear.
  • Full id_str list and ranges: Parameters.