Sleepy Circuits Hypno: MIDI CC, NRPN and OSC map¶
The Sleepy Circuits Hypno as named OSC addresses — 49 CC, 10 drum sounds — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Sleepy Circuits Hypno |
|---|---|
| Vendor | Sleepy Circuits |
| OSC prefix | /hypno |
| 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/sleepy-circuits/hypno.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/sleepy-circuits/hypno.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 hypno: ask “what can the Sleepy Circuits Hypno do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (49)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/hypno/main_page/frequency_a |
1 | 0–127 | continuous | Main Page | |
/hypno/main_page/color |
2 | 0–127 | continuous | Main Page | |
/hypno/main_page/frequency_b |
3 | 0–127 | continuous | Main Page | |
/hypno/main_page/master_gain |
4 | 0–127 | continuous | Main Page | |
/hypno/main_page/rotation_a |
5 | 0–127 | continuous | Main Page | |
/hypno/main_page/rotation_b |
6 | 0–127 | continuous | Main Page | |
/hypno/main_page/polarization_a |
7 | 0–127 | continuous | Main Page | |
/hypno/main_page/polarization_b |
8 | 0–127 | continuous | Main Page | |
/hypno/shape_a/drift_a |
9 | 0–127 | continuous | Shape A | |
/hypno/shape_a/a_color_offset |
10 | 0–127 | continuous | Shape A | |
/hypno/shape_a/a_b_gain |
11 | 0–127 | continuous | Shape A | |
/hypno/shape_a/saturation_a |
12 | 0–127 | continuous | Shape A | |
/hypno/shape_a/self_mod_rotation_a |
13 | 0–127 | continuous | Shape A | |
/hypno/shape_a/fractal_axis_a |
14 | 0–127 | continuous | Shape A | |
/hypno/shape_a/fractal_amount_a |
15 | 0–127 | continuous | Shape A | |
/hypno/shape_a/self_mod_polar_fractal_a |
16 | 0–127 | continuous | Shape A | |
/hypno/shape_b/drift_b |
17 | 0–127 | continuous | Shape B | |
/hypno/shape_b/b_color_offset |
18 | 0–127 | continuous | Shape B | |
/hypno/shape_b/b_a_gain |
19 | 0–127 | continuous | Shape B | |
/hypno/shape_b/saturation_b |
20 | 0–127 | continuous | Shape B | |
/hypno/shape_b/self_mod_rotation_b |
21 | 0–127 | continuous | Shape B | |
/hypno/shape_b/fractal_axis_b |
22 | 0–127 | continuous | Shape B | |
/hypno/shape_b/fractal_amount_b |
23 | 0–127 | continuous | Shape B | |
/hypno/shape_b/self_mod_polar_fractal_b |
24 | 0–127 | continuous | Shape B | |
/hypno/feedback/fb_a_gain |
25 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_hue_shift |
26 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_b_gain |
27 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_zoom |
28 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_rotation |
29 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_rotation_self_mod |
30 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_x_offset |
31 | 0–127 | continuous | Feedback | |
/hypno/feedback/fb_y_offset |
32 | 0–127 | continuous | Feedback | |
/hypno/video_a/x_crop_a |
33 | 0–127 | continuous | Video A | |
/hypno/video_a/lumakey_min_a |
34 | 0–127 | continuous | Video A | |
/hypno/video_a/y_crop_a |
35 | 0–127 | continuous | Video A | |
/hypno/video_a/lumakey_max_a |
36 | 0–127 | continuous | Video A | |
/hypno/video_a/file_index_a |
37 | 0–127 | continuous | Video A | |
/hypno/video_a/aspect_a |
38 | 0–127 | continuous | Video A | |
/hypno/video_a/folder_a |
39 | 0–127 | continuous | Video A | |
/hypno/video_b/x_crop_b |
41 | 0–127 | continuous | Video B | |
/hypno/video_b/lumakey_min_b |
42 | 0–127 | continuous | Video B | |
/hypno/video_b/y_crop_b |
43 | 0–127 | continuous | Video B | |
/hypno/video_b/lumakey_max_b |
44 | 0–127 | continuous | Video B | |
/hypno/video_b/file_index_b |
45 | 0–127 | continuous | Video B | |
/hypno/video_b/aspect_b |
46 | 0–127 | continuous | Video B | |
/hypno/video_b/folder_b |
47 | 0–127 | continuous | Video B | |
/hypno/mode_index/shape_index_a |
49 | 0–127 | continuous | Mode Index | |
/hypno/mode_index/shape_index_b |
50 | 0–127 | continuous | Mode Index | |
/hypno/mode_index/fb_mode_index |
51 | 0–127 | continuous | Mode Index |
Drum sounds (10)¶
Send <address> [velocity] [note] [channel] to fire the sound (Note On).
| OSC address | Sound | Note(s) | Channel | Velocity |
|---|---|---|---|---|
/hypno/drum/preset_recall_save |
Preset recall / save | 2–116 (natural 2) | 16 | |
/hypno/drum/toggle_a_shape |
Toggle A Shape | 118 | 16 | |
/hypno/drum/toggle_b_shape |
Toggle B Shape | 121 | 16 | |
/hypno/drum/toggle_fb_mode |
Toggle FB Mode | 123 | 16 | |
/hypno/drum/toggle_a_b |
Toggle A->B | 127 | 16 | |
/hypno/drum/toggle_a_main |
Toggle A->Main | 125 | 16 | |
/hypno/drum/toggle_b_a |
Toggle B->A | 124 | 16 | |
/hypno/drum/toggle_b_main |
Toggle B->Main | 122 | 16 | |
/hypno/drum/toggle_fb_a |
Toggle FB->A | 120 | 16 | |
/hypno/drum/toggle_fb_b |
Toggle FB->B | 119 | 16 |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /hypno/note/on <note> <velocity>, /hypno/cc/<number> <value>, /hypno/pitchbend <0-16383>, /hypno/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.