Complete Guide to Remapping MIDI with MIDIHub

MIDIHub’s remap rules let you transform any aspect of your MIDI data - transpose notes, change channels, scale velocities, reassign controllers, and much more.

Understanding Remap Rules

Remap rules process all messages of their selected type. You can:

• Transform values (change channel 1 to channel 2)
• Duplicate messages (send to multiple destinations with comma-separated values)
• Filter out specific values (leave the field empty)
• Map multiple values simultaneously

Setting Up a Remap Rule

1. Open the Rulebook

Select any port and tap the Rulebook icon. You’ll see the Main Chain where you can add rules.

2. Add a Remap/Filter Rule

Tap “Add Rule” and select “Remap/Filter”.

3. Choose What to Remap

The dropdown menu lets you select what type of MIDI data to transform:

• Channel - Route between MIDI channels 1-16
• Note - Transpose or reassign specific notes
• Velocity - Scale or fix velocity values
• Polyphonic Aftertouch - Remap poly pressure messages
• Control Change - Reassign CC numbers
• Program Change - Remap program/patch numbers
• Channel Aftertouch - Transform channel pressure

Remap Rule Syntax

When you open a remap rule, you’ll see a list where you can set each value:

Note 60 is set to 60, 64, 67  // Creates C major chord
Note 61 is set to ""          // Filters out C#
Note 62 is set to 50          // Remaps D to D below
Note 63 is set to 63, 75      // Doubles Eb an octave up
Note 64 is set to 64          // E stays as E
Note 65 is set to ""          // Filters out F

• Use comma-separated values to send to multiple destinations
• Leave empty ("") to filter out that value
• Single values for one-to-one mapping

Practical Examples

Channel Remapping

Layer two instruments:

Type: Channel
Channel 1 → 1,2
// Plays on both channel 1 and 2 simultaneously

Reorganize your setup:

Type: Channel
Channel 10 → 16  // Move drums to channel 16
Channel 3 → 10   // Move bass to old drum channel

Note Transposition and Mapping

Transpose everything up an octave:

Type: Note
Note 0 is set to 12
Note 1 is set to 13
Note 2 is set to 14
// Continue pattern for all notes

Create custom drum mappings:

Type: Note
Note 36 is set to 36, 38, 42  // Kick triggers kick+snare+hihat
Note 37 is set to ""           // Remove rim click
Note 38 is set to 40           // Snare to electric snare

Velocity Transformation

Fix all velocities:

Type: Velocity
All inputs → 100
// Every note plays at velocity 100

Create velocity layers:

Type: Velocity
0-63 → 80    // Quiet notes become mezzo-forte
64-127 → 127  // Loud notes become fortissimo

Control Change Remapping

Convert controllers:

Type: Control Change
CC 1 → 11   // Mod wheel to expression
CC 7 → 7,10  // Volume also controls pan

Filter unwanted CCs:

Type: Control Change
CC 123 → (empty)  // Remove "All Notes Off"

Tips for Effective Remapping

Order Matters

Rules within a ruleset apply sequentially. If you remap channel 1 to 2, then 2 to 3, a channel 1 message becomes channel 3.

Combine with Other Rules

• Use Filter rules first to remove unwanted message types
• Apply Remap rules to transform what remains
• Add Custom rules for complex conditional logic

Test Your Mappings

• Use the built-in test generator to send notes through your rules
• Monitor the output with port logs
• Save working configurations as presets

With MIDIHub’s remap rules, you have complete control over how MIDI data flows through your setup. Transform, route, duplicate, or filter any aspect of your MIDI stream with ease.