Yamaha reface YC: MIDI CC, NRPN and OSC map¶
The Yamaha reface YC as named OSC addresses — 18 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Yamaha reface YC |
|---|---|
| Vendor | Yamaha |
| OSC prefix | /reface_yc |
| 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/yamaha/reface_yc.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/yamaha/reface_yc.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 reface_yc: ask “what can the Yamaha reface YC do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (18)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/reface_yc/sound/rotary_speed |
19 | 0–127 | continuous | Sound | |
/reface_yc/sound/wave |
80 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_16 |
102 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_5_1_3 |
103 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_8 |
104 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_4 |
105 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_2_2_3 |
106 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_2 |
107 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_1_3_5 |
108 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_1_1_3 |
109 | 0–127 | continuous | Sound | |
/reface_yc/sound/footage_1 |
110 | 0–127 | continuous | Sound | |
/reface_yc/vibrato_chorus/switch |
79 | 0–127 | continuous | Vibrato/chorus | |
/reface_yc/vibrato_chorus/depth |
77 | 0–127 | continuous | Vibrato/chorus | |
/reface_yc/percussion/on_off_switch |
111 | 0–127 | continuous | Percussion | |
/reface_yc/percussion/type_switch |
112 | 0–127 | continuous | Percussion | |
/reface_yc/percussion/length |
113 | 0–127 | continuous | Percussion | |
/reface_yc/effects/effect_dist |
18 | 0–127 | continuous | Effects | |
/reface_yc/effects/effect_reverb |
91 | 0–127 | continuous | Effects |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /reface_yc/note/on <note> <velocity>, /reface_yc/cc/<number> <value>, /reface_yc/pitchbend <0-16383>, /reface_yc/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.