HeadRush Prime MIDI CC chart, NRPN and OSC map¶
The HeadRush Prime MIDI implementation: 37 CC, each named, for Claude (MCP), SuperCollider or any OSC app.
| 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.
Frequently asked questions¶
How many parameters of the HeadRush Prime can be controlled over MIDI?
SynthHub's map of the HeadRush Prime lists 37 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.
Can an AI agent like Claude control the HeadRush Prime?
Yes: SynthHub's hosted MCP server knows the HeadRush Prime's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.