KORG Wavestate: MIDI CC, NRPN and OSC map¶
The KORG Wavestate as named OSC addresses — 166 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | KORG Wavestate |
|---|---|
| Vendor | KORG |
| OSC prefix | /wavestate |
| Source | 🎛️ Derived from an Electra One community preset |
| Revision | per pencilresearch canonical CSV |
| Upstream | electra-preset |
| Driver file | devices/korg/wavestate.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/wavestate.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 wavestate: ask “what can the KORG Wavestate do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (166)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/wavestate/general/modulation |
1 | 0–127 | continuous | General | |
/wavestate/general/volume |
7 | 0–127 | continuous | General | |
/wavestate/general/pan |
10 | 0–127 | continuous | General | |
/wavestate/general/expression |
11 | 0–127 | continuous | General | |
/wavestate/vector/joystick_x |
16 | 0–127 | continuous | Vector | |
/wavestate/vector/joystick_y |
17 | 0–127 | continuous | Vector | |
/wavestate/pedals/damper |
64 | 0–127 | continuous | Pedals | |
/wavestate/pedals/sostenuto |
66 | 0–127 | continuous | Pedals | |
/wavestate/pedals/soft |
67 | 0–127 | continuous | Pedals | |
/wavestate/general/all_sounds_off |
120 | 0–127 | continuous | General | |
/wavestate/general/reset_all_controllers |
121 | 0–127 | continuous | General | |
/wavestate/assignable/cc_2 |
2 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_3 |
3 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_4 |
4 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_5 |
5 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_6 |
6 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_8 |
8 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_9 |
9 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_12 |
12 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_13 |
13 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_14 |
14 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_15 |
15 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_16 |
16 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_17 |
17 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_18 |
18 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_19 |
19 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_20 |
20 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_21 |
21 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_22 |
22 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_23 |
23 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_24 |
24 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_25 |
25 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_26 |
26 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_27 |
27 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_28 |
28 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_29 |
29 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_30 |
30 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_31 |
31 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_32 |
32 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_33 |
33 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_34 |
34 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_35 |
35 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_36 |
36 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_37 |
37 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_38 |
38 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_39 |
39 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_40 |
40 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_41 |
41 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_42 |
42 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_43 |
43 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_44 |
44 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_45 |
45 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_46 |
46 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_47 |
47 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_48 |
48 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_49 |
49 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_50 |
50 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_51 |
51 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_52 |
52 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_53 |
53 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_54 |
54 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_55 |
55 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_56 |
56 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_57 |
57 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_58 |
58 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_59 |
59 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_60 |
60 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_61 |
61 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_62 |
62 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_63 |
63 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_65 |
65 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_67 |
67 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_68 |
68 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_69 |
69 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_70 |
70 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_71 |
71 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_72 |
72 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_73 |
73 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_74 |
74 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_75 |
75 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_76 |
76 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_77 |
77 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_78 |
78 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_79 |
79 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_80 |
80 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_81 |
81 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_82 |
82 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_83 |
83 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_84 |
84 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_85 |
85 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_86 |
86 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_87 |
87 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_88 |
88 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_89 |
89 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_90 |
90 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_91 |
91 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_92 |
92 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_93 |
93 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_94 |
94 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_95 |
95 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_102 |
102 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_103 |
103 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_104 |
104 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_105 |
105 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_106 |
106 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_107 |
107 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_108 |
108 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_109 |
109 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_110 |
110 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_111 |
111 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_112 |
112 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_113 |
113 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_114 |
114 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_115 |
115 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_116 |
116 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_117 |
117 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_118 |
118 | 0–127 | continuous | Assignable | |
/wavestate/assignable/cc_119 |
119 | 0–127 | continuous | Assignable | |
/wavestate/1_master |
24 | 0–127 | continuous | ||
/wavestate/2_timing |
25 | 0–127 | continuous | ||
/wavestate/3_sample |
26 | 0–127 | continuous | ||
/wavestate/4_pitch |
27 | 0–127 | continuous | ||
/wavestate/5_shape |
28 | 0–127 | continuous | ||
/wavestate/6_gate |
29 | 0–127 | continuous | ||
/wavestate/7_step_seq |
30 | 0–127 | continuous | ||
/wavestate/8_speed |
31 | 0–127 | continuous | ||
/wavestate/1_master |
80 | 0–127 | continuous | ||
/wavestate/2_timing |
81 | 0–127 | continuous | ||
/wavestate/3_sample |
82 | 0–127 | continuous | ||
/wavestate/4_pitch |
83 | 0–127 | continuous | ||
/wavestate/expression |
11 | 0–127 | continuous | ||
/wavestate/pan |
10 | -64–63 | continuous | ||
/wavestate/5_shape |
84 | 0–127 | continuous | ||
/wavestate/6_gate |
85 | 0–127 | continuous | ||
/wavestate/7_step_seq |
86 | 0–127 | continuous | ||
/wavestate/8_speed |
87 | 0–127 | continuous | ||
/wavestate/a_vector_c |
16 | -64–63 | continuous | ||
/wavestate/b_vector_d |
17 | -64–63 | continuous | ||
/wavestate/1_master |
88 | 0–127 | continuous | ||
/wavestate/2_timing |
89 | 0–127 | continuous | ||
/wavestate/3_sample |
90 | 0–127 | continuous | ||
/wavestate/4_pitch |
91 | 0–127 | continuous | ||
/wavestate/all_sounds_off |
120 | 0–127 | continuous | ||
/wavestate/scale_select |
9 | 0–127 | continuous | ||
/wavestate/5_shape |
92 | 0–127 | continuous | ||
/wavestate/6_gate |
93 | 0–127 | continuous | ||
/wavestate/7_step_seq |
94 | 0–127 | continuous | ||
/wavestate/8_speed |
95 | 0–127 | continuous | ||
/wavestate/hold |
64 | 0–127 | continuous | ||
/wavestate/sostenuto |
66 | 0–127 | continuous | ||
/wavestate/1_master |
102 | 0–127 | continuous | ||
/wavestate/2_timing |
103 | 0–127 | continuous | ||
/wavestate/3_sample |
104 | 0–127 | continuous | ||
/wavestate/4_pitch |
105 | 0–127 | continuous | ||
/wavestate/5_shape |
106 | 0–127 | continuous | ||
/wavestate/6_gate |
107 | 0–127 | continuous | ||
/wavestate/7_step_seq |
108 | 0–127 | continuous | ||
/wavestate/8_speed |
109 | 0–127 | continuous | ||
/wavestate/1_master |
110 | 0–127 | continuous | ||
/wavestate/2_timing |
111 | 0–127 | continuous | ||
/wavestate/3_sample |
112 | 0–127 | continuous | ||
/wavestate/4_pitch |
113 | 0–127 | continuous | ||
/wavestate/5_shape |
114 | 0–127 | continuous | ||
/wavestate/6_gate |
115 | 0–127 | continuous | ||
/wavestate/7_step_seq |
116 | 0–127 | continuous | ||
/wavestate/8_speed |
117 | 0–127 | continuous |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /wavestate/note/on <note> <velocity>, /wavestate/cc/<number> <value>, /wavestate/pitchbend <0-16383>, /wavestate/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.