Beetlecrab.audio Vector: MIDI CC, NRPN and OSC map¶
The Beetlecrab.audio Vector as named OSC addresses — 54 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Beetlecrab.audio Vector |
|---|---|
| Vendor | Beetlecrab.audio |
| OSC prefix | /vector |
| 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/beetlecrab-audio/vector.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/beetlecrab-audio/vector.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 vector: ask “what can the Beetlecrab.audio Vector do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (54)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/vector/orbiter/center_position_x |
3 | 0–127 | continuous | Orbiter | |
/vector/orbiter/center_position_y |
4 | 0–127 | continuous | Orbiter | |
/vector/orbiter/width |
5 | 0–127 | continuous | Orbiter | |
/vector/orbiter/height |
48 | 0–127 | continuous | Orbiter | |
/vector/orbiter/lissajous_warp_x |
7 | 0–127 | continuous | Orbiter | |
/vector/orbiter/lissajous_warp_y |
8 | 0–127 | continuous | Orbiter | |
/vector/orbiter/suborbit_size |
2 | 0–127 | continuous | Orbiter | |
/vector/orbiter/suborbit_speed |
47 | 0–127 | continuous | Orbiter | |
/vector/orbiter/orbit_attack |
43 | 0–127 | continuous | Orbiter | |
/vector/orbiter/orbit_decay |
44 | 0–127 | continuous | Orbiter | |
/vector/orbiter/orbit_release |
45 | 0–127 | continuous | Orbiter | |
/vector/envelope/attack |
13 | 0–127 | continuous | Envelope | |
/vector/envelope/decay |
14 | 0–127 | continuous | Envelope | |
/vector/envelope/sustain |
15 | 0–127 | continuous | Envelope | |
/vector/envelope/release |
50 | 0–127 | continuous | Envelope | |
/vector/filter/global_resonance |
25 | 0–127 | continuous | Filter | |
/vector/drive/amount |
21 | 0–127 | continuous | Drive | |
/vector/drive/colour |
22 | 0–127 | continuous | Drive | |
/vector/reverb/amount |
10 | 0–127 | continuous | Reverb | |
/vector/reverb/size |
23 | 0–127 | continuous | Reverb | |
/vector/reverb/colour |
24 | 0–127 | continuous | Reverb | |
/vector/chorus/mix |
11 | 0–127 | continuous | Chorus | |
/vector/chorus/speed |
28 | 0–127 | continuous | Chorus | |
/vector/chorus/depth |
29 | 0–127 | continuous | Chorus | |
/vector/chorus/colour |
30 | 0–127 | continuous | Chorus | |
/vector/delay/mix |
12 | 0–127 | continuous | Delay | |
/vector/delay/time |
26 | 0–127 | continuous | Delay | |
/vector/delay/feedback |
27 | 0–127 | continuous | Delay | |
/vector/modulation/vibrato_depth |
18 | 0–127 | continuous | Modulation | |
/vector/modulation/vibrato_speed |
51 | 0–127 | continuous | Modulation | |
/vector/modulation/tremolo_speed |
19 | 0–127 | continuous | Modulation | |
/vector/modulation/tremolo_depth |
20 | 0–127 | continuous | Modulation | |
/vector/arpeggiator/note_length |
31 | 0–127 | continuous | Arpeggiator | |
/vector/arpeggiator/humanize |
46 | 0–127 | continuous | Arpeggiator | |
/vector/mono/stack_volume |
33 | 0–127 | continuous | Mono | |
/vector/mono/detune_stack |
34 | 0–127 | continuous | Mono | |
/vector/mono/glide |
35 | 0–127 | continuous | Mono | |
/vector/mono/voices |
36 | 0–127 | continuous | Mono | |
/vector/dual/follower_volume |
37 | 0–127 | continuous | Dual | |
/vector/dual/suborbit_offset |
39 | 0–127 | continuous | Dual | |
/vector/dual/stereo_bias |
40 | 0–127 | continuous | Dual | |
/vector/dual/detune_follower |
52 | 0–127 | continuous | Dual | |
/vector/poly/detune_drift |
41 | 0–127 | continuous | Poly | |
/vector/poly/stereo_scatter |
42 | 0–127 | continuous | Poly | |
/vector/routing/routable_parameter |
115 | 0–127 | continuous | Routing | |
/vector/system/bank_select_msb |
0 | 0–127 | continuous | System | |
/vector/system/bank_select_lsb |
32 | 0–127 | continuous | System | |
/vector/system/data_entry_msb |
6 | 0–127 | continuous | System | |
/vector/system/data_entry_lsb |
38 | 0–127 | continuous | System | |
/vector/system/volume |
49 | 0–127 | continuous | System | |
/vector/system/damper_sustain_pedal |
64 | 0–127 | continuous | System | |
/vector/system/sostenuto_pedal |
66 | 0–127 | continuous | System | |
/vector/system/registered_parameter_number_lsb |
100 | 0–127 | continuous | System | |
/vector/system/registered_parameter_number_msb |
101 | 0–127 | continuous | System |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /vector/note/on <note> <velocity>, /vector/cc/<number> <value>, /vector/pitchbend <0-16383>, /vector/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.