HeadRush Prime: MIDI CC, NRPN and OSC map¶
The HeadRush Prime as named OSC addresses — 37 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | HeadRush Prime |
|---|---|
| Vendor | HeadRush |
| OSC prefix | /prime |
| 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/headrush/prime.pencilresearch.fw-unknown.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/headrush/prime.pencilresearch.fw-unknown.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 prime: ask “what can the HeadRush Prime do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (37)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/prime/footswitches/footswitch_1 |
49 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_2 |
50 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_3 |
51 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_4 |
52 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_5 |
53 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_6 |
54 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_7 |
55 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_8 |
56 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_9 |
57 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_10 |
58 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_11 |
59 | 0–127 | continuous | Footswitches | |
/prime/footswitches/footswitch_12 |
60 | 0–127 | continuous | Footswitches | |
/prime/global_controls/tap_tempo |
64 | 0–127 | continuous | Global controls | |
/prime/looper/half_speed |
65 | 0–127 | continuous | Looper | |
/prime/looper/double_speed |
66 | 0–127 | continuous | Looper | |
/prime/looper/half_speed_loop |
67 | 0–127 | continuous | Looper | |
/prime/looper/double_speed_loop |
68 | 0–127 | continuous | Looper | |
/prime/looper/start_stop |
69 | 0–127 | continuous | Looper | |
/prime/looper/record |
70 | 0–127 | continuous | Looper | |
/prime/looper/insert |
71 | 0–127 | continuous | Looper | |
/prime/looper/peel |
72 | 0–127 | continuous | Looper | |
/prime/looper/mute |
73 | 0–127 | continuous | Looper | |
/prime/looper/reverse |
74 | 0–127 | continuous | Looper | |
/prime/blocks/block_1_toggle_on_off |
75 | 0–127 | continuous | Blocks | |
/prime/blocks/block_2_toggle_on_off |
76 | 0–127 | continuous | Blocks | |
/prime/blocks/block_3_toggle_on_off |
77 | 0–127 | continuous | Blocks | |
/prime/blocks/block_4_toggle_on_off |
78 | 0–127 | continuous | Blocks | |
/prime/blocks/block_5_toggle_on_off |
79 | 0–127 | continuous | Blocks | |
/prime/blocks/block_6_toggle_on_off |
80 | 0–127 | continuous | Blocks | |
/prime/blocks/block_7_toggle_on_off |
81 | 0–127 | continuous | Blocks | |
/prime/blocks/block_8_toggle_on_off |
82 | 0–127 | continuous | Blocks | |
/prime/blocks/block_9_toggle_on_off |
83 | 0–127 | continuous | Blocks | |
/prime/blocks/block_10_toggle_on_off |
84 | 0–127 | continuous | Blocks | |
/prime/blocks/block_11_toggle_on_off |
85 | 0–127 | continuous | Blocks | |
/prime/blocks/block_12_toggle_on_off |
86 | 0–127 | continuous | Blocks | |
/prime/blocks/block_13_toggle_on_off |
87 | 0–127 | continuous | Blocks | |
/prime/blocks/block_14_toggle_on_off |
88 | 0–127 | continuous | Blocks |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /prime/note/on <note> <velocity>, /prime/cc/<number> <value>, /prime/pitchbend <0-16383>, /prime/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.