KORG R3: MIDI CC, NRPN and OSC map¶
The KORG R3 as named OSC addresses — 61 CC, 68 NRPN — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | KORG R3 |
|---|---|
| Vendor | KORG |
| OSC prefix | /r3 |
| Source | 📦 Derived from MIDI Guide (community CC/NRPN data) |
| Firmware | unknown |
| Revision | per pencilresearch canonical CSV |
| Upstream | pencilresearch |
| Data licence | CC-BY-SA-4.0 — MIDI Guide (https://midi.guide) by Pencil Research and contributors |
| Driver file | devices/korg/r3.json |
Not tested on the device yet
This driver comes from documentation or community data and has not been checked on real hardware. If you own one, a quick test and a pull request promoting it helps everyone — see CONTRIBUTING.
How do you control it?¶
Find the MIDI ports, then start the bridge with this driver:
osc-bridge detect # prints the ready-to-run line for what is plugged in
osc-bridge run --device devices/korg/r3.json --out-port <N> --in-port <M>
Then send OSC to 127.0.0.1:7777, for example:
From Claude or any MCP client, the osc-bridge mcp server exposes this driver as r3: ask “what can the KORG R3 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (129)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/r3/performance/modulation_depth |
1 | 0–127 | continuous | Performance | |
/r3/performance/expression |
11 | 0–127 | continuous | Performance | |
/r3/performance/damper_pedal |
64 | 0–127 | continuous | Performance | |
/r3/performance/portamento_switch |
65 | 0–127 | continuous | Performance | |
/r3/unison/switch |
3 | 0–127 | continuous | Unison | |
/r3/pitch/portamento_time |
5 | 0–127 | continuous | Pitch | |
/r3/oscillator_1/waveform |
8 | 0–127 | continuous | Oscillator 1 | |
/r3/oscillator_1/mod_type |
9 | 0–127 | continuous | Oscillator 1 | |
/r3/oscillator_1/control_1 |
15 | 0–127 | continuous | Oscillator 1 | |
/r3/oscillator_1/control_2 |
17 | 0–127 | continuous | Oscillator 1 | |
/r3/oscillator_2/waveform |
18 | 0–127 | continuous | Oscillator 2 | |
/r3/oscillator_2/mod_type |
19 | 0–127 | continuous | Oscillator 2 | |
/r3/oscillator_2/semitone |
20 | 0–127 | continuous | Oscillator 2 | |
/r3/oscillator_2/tune |
21 | 0–127 | continuous | Oscillator 2 | |
/r3/mixer/oscillator_1_level |
23 | 0–127 | continuous | Mixer | |
/r3/mixer/oscillator_2_level |
24 | 0–127 | continuous | Mixer | |
/r3/mixer/noise_level |
25 | 0–127 | continuous | Mixer | |
/r3/filter_1/cutoff |
74 | 0–127 | continuous | Filter 1 | |
/r3/filter_1/resonance |
71 | 0–127 | continuous | Filter 1 | |
/r3/filter_1/balance |
27 | 0–127 | continuous | Filter 1 | |
/r3/filter_1/routing |
26 | 0–127 | continuous | Filter 1 | |
/r3/filter_1/envelope_1_intensity |
79 | 0–127 | continuous | Filter 1 | |
/r3/filter_1/key_track |
28 | 0–127 | continuous | Filter 1 | |
/r3/filter_2/cutoff |
30 | 0–127 | continuous | Filter 2 | |
/r3/filter_2/resonance |
68 | 0–127 | continuous | Filter 2 | |
/r3/filter_2/type |
29 | 0–127 | continuous | Filter 2 | |
/r3/filter_2/envelope_1_intensity |
69 | 0–127 | continuous | Filter 2 | |
/r3/filter_2/key_track |
82 | 0–127 | continuous | Filter 2 | |
/r3/amplifier/level |
7 | 0–127 | continuous | Amplifier | |
/r3/amplifier/pan |
10 | 0–127 | continuous | Amplifier | |
/r3/drive/waveshaper_depth |
83 | 0–127 | continuous | Drive | |
/r3/envelope_1/attack |
65 | 0–127 | continuous | Envelope 1 | |
/r3/envelope_1/decay |
86 | 0–127 | continuous | Envelope 1 | |
/r3/envelope_1/sustain |
87 | 0–127 | continuous | Envelope 1 | |
/r3/envelope_1/release |
88 | 0–127 | continuous | Envelope 1 | |
/r3/envelope_2/attack |
73 | 0–127 | continuous | Envelope 2 | |
/r3/envelope_2/decay |
75 | 0–127 | continuous | Envelope 2 | |
/r3/envelope_2/sustain |
70 | 0–127 | continuous | Envelope 2 | |
/r3/envelope_2/release |
72 | 0–127 | continuous | Envelope 2 | |
/r3/lfo_1/waveform |
89 | 0–127 | continuous | LFO 1 | |
/r3/lfo_1/frequency |
90 | 0–127 | continuous | LFO 1 | |
/r3/lfo_2/waveform |
102 | 0–127 | continuous | LFO 2 | |
/r3/lfo_2/frequency |
76 | 0–127 | continuous | LFO 2 | |
/r3/virtual_patch/patch_1_source |
4 / 0 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_1_destination |
4 / 8 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_1_intensity |
103 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_2_source |
4 / 1 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_2_destination |
4 / 9 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_2_intensity |
104 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_3_source |
4 / 2 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_3_destination |
4 / 10 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_3_intensity |
105 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_4_source |
4 / 3 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_4_destination |
4 / 11 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_4_intensity |
106 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_5_source |
4 / 4 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_5_destination |
4 / 12 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_5_intensity |
107 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_6_source |
4 / 5 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_6_destination |
4 / 13 | 0–127 | continuous | Virtual patch | |
/r3/virtual_patch/patch_6_intensity |
108 | 0–127 | continuous | Virtual patch | |
/r3/equalizer/low_gain |
110 | 0–127 | continuous | Equalizer | |
/r3/equalizer/high_gain |
109 | 0–127 | continuous | Equalizer | |
/r3/mod_sequence/switch |
111 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_1 |
4 / 16 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_2 |
4 / 17 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_3 |
4 / 18 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_4 |
4 / 19 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_5 |
4 / 20 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_6 |
4 / 21 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_7 |
4 / 22 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_8 |
4 / 23 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_9 |
4 / 24 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_10 |
4 / 25 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_11 |
4 / 26 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_12 |
4 / 27 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_13 |
4 / 28 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_14 |
4 / 29 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_15 |
4 / 30 | 0–127 | continuous | Mod sequence | |
/r3/mod_sequence/step_16 |
4 / 31 | 0–127 | continuous | Mod sequence | |
/r3/effects/insert_effect_1_dry_wet |
115 | 0–127 | continuous | Effects | |
/r3/effects/insert_effect_1_knob |
12 | 0–127 | continuous | Effects | |
/r3/effects/insert_effect_2_dry_wet |
116 | 0–127 | continuous | Effects | |
/r3/effects/insert_effect_2_knob |
13 | 0–127 | continuous | Effects | |
/r3/effects/master_effect_dry_wet |
94 | 0–127 | continuous | Effects | |
/r3/effects/master_effect_knob |
114 | 0–127 | continuous | Effects | |
/r3/arpeggiator/on_off |
0 / 2 | 0–127 | continuous | Arpeggiator | |
/r3/arpeggiator/latch |
0 / 4 | 0–127 | continuous | Arpeggiator | |
/r3/arpeggiator/type |
0 / 7 | 0–127 | continuous | Arpeggiator | |
/r3/arpeggiator/gate |
0 / 10 | 0–127 | continuous | Arpeggiator | |
/r3/arpeggiator/select |
0 / 11 | 1–127 | continuous | Arpeggiator | |
/r3/vocoder/fc_mod_source |
4 / 0 | 0–127 | continuous | Vocoder | |
/r3/vocoder/switch |
5 / 4 | 0–127 | continuous | Vocoder | |
/r3/vocoder_channels/channel_1_level |
4 / 64 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_2_level |
4 / 65 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_3_level |
4 / 66 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_4_level |
4 / 67 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_5_level |
4 / 68 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_6_level |
4 / 69 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_7_level |
4 / 70 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_8_level |
4 / 71 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_9_level |
4 / 72 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_10_level |
4 / 73 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_11_level |
4 / 74 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_12_level |
4 / 75 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_13_level |
4 / 76 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_14_level |
4 / 77 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_15_level |
4 / 78 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_16_level |
4 / 79 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_1_pan |
4 / 80 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_2_pan |
4 / 81 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_3_pan |
4 / 82 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_4_pan |
4 / 83 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_5_pan |
4 / 84 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_6_pan |
4 / 85 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_7_pan |
4 / 86 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_8_pan |
4 / 87 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_9_pan |
4 / 88 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_10_pan |
4 / 89 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_11_pan |
4 / 90 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_12_pan |
4 / 91 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_13_pan |
4 / 92 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_14_pan |
4 / 93 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_15_pan |
4 / 94 | 0–127 | continuous | Vocoder channels | |
/r3/vocoder_channels/channel_16_pan |
4 / 95 | 0–127 | continuous | Vocoder channels | |
/r3/voice/mode |
5 / 0 | 0–127 | continuous | Voice | |
/r3/channel_mode/all_note_off |
123 | 0–0 | continuous | Channel mode | |
/r3/channel_mode/all_sound_off |
120 | 0–0 | continuous | Channel mode | |
/r3/channel_mode/reset_all_controllers |
121 | 0–0 | continuous | Channel mode |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /r3/note/on <note> <velocity>, /r3/cc/<number> <value>, /r3/pitchbend <0-16383>, /r3/program_change <n>.
Limitations¶
CC/NRPN only. SysEx (preset management, display control, bulk dump/load, vendor-proprietary opcodes) is NOT covered by pencilresearch. To extend this device with SysEx, sniff the vendor editor, add `sysex.header/footer` + `commands` blocks, and use `update_device.md` PR template.