Hologram Microcosm: MIDI CC, NRPN and OSC map¶
The Hologram Microcosm as named OSC addresses — 35 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Hologram Microcosm |
|---|---|
| Vendor | Hologram |
| OSC prefix | /microcosm |
| 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/hologram/microcosm.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.
Other variants of this device: microcosm.
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/hologram/microcosm.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 microcosm: ask “what can the Hologram Microcosm do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (35)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/microcosm/time/subdivision |
5 | 0–127 | continuous | Time | |
/microcosm/special_sauce/activity |
6 | 0–127 | continuous | Special Sauce | |
/microcosm/modulation/shape |
7 | 0–127 | continuous | Modulation | |
/microcosm/filter/cutoff |
8 | 0–127 | continuous | Filter | |
/microcosm/effect/mix |
9 | 0–127 | continuous | Effect | |
/microcosm/time/time |
10 | 0–127 | continuous | Time | |
/microcosm/special_sauce/repeats |
11 | 0–127 | continuous | Special Sauce | |
/microcosm/reverb/space |
12 | 0–127 | continuous | Reverb | |
/microcosm/looper/loop_level |
13 | 0–127 | continuous | Looper | |
/microcosm/modulation/frequency |
14 | 0–127 | continuous | Modulation | |
/microcosm/filter/resonance |
15 | 0–127 | continuous | Filter | |
/microcosm/effect/volume |
16 | 0–127 | continuous | Effect | |
/microcosm/looper/playback_speed |
17 | 0–127 | continuous | Looper | |
/microcosm/looper/playback_stepped |
18 | 0–127 | continuous | Looper | |
/microcosm/modulation/depth |
19 | 0–127 | continuous | Modulation | |
/microcosm/reverb/time |
20 | 0–127 | continuous | Reverb | |
/microcosm/looper/fade_time |
21 | 0–127 | continuous | Looper | |
/microcosm/looper/on_off |
22 | 0–127 | continuous | Looper | |
/microcosm/looper/playback_direction |
23 | 0–127 | continuous | Looper | |
/microcosm/looper/routing |
24 | 0–127 | continuous | Looper | |
/microcosm/looper/only |
25 | 0–127 | continuous | Looper | |
/microcosm/looper/burst |
26 | 0–127 | continuous | Looper | |
/microcosm/looper/quantized |
27 | 0–127 | continuous | Looper | |
/microcosm/looper/record |
28 | 0–127 | continuous | Looper | |
/microcosm/looper/play |
29 | 0–127 | continuous | Looper | |
/microcosm/looper/overdub |
30 | 0–127 | continuous | Looper | |
/microcosm/looper/stop |
31 | 0–127 | continuous | Looper | |
/microcosm/looper/erase |
34 | 0–127 | continuous | Looper | |
/microcosm/looper/undo |
35 | 0–127 | continuous | Looper | |
/microcosm/preset/copy |
45 | 0–127 | continuous | Preset | |
/microcosm/preset/save |
46 | 0–127 | continuous | Preset | |
/microcosm/effect/reverse_effect |
47 | 0–127 | continuous | Effect | |
/microcosm/time/hold_sampler |
48 | 0–127 | continuous | Time | |
/microcosm/time/tap_tempo |
93 | 0–127 | continuous | Time | |
/microcosm/effect/bypass |
102 | 0–127 | continuous | Effect |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /microcosm/note/on <note> <velocity>, /microcosm/cc/<number> <value>, /microcosm/pitchbend <0-16383>, /microcosm/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.