Yamaha TX-81Z base: MIDI CC, NRPN and OSC map¶
The Yamaha TX-81Z base as named OSC addresses — 2 CC, 77 SysEx commands — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Yamaha TX-81Z base |
|---|---|
| Vendor | Yamaha |
| OSC prefix | /tx_81z_base |
| Source | 🎛️ Derived from an Electra One community preset |
| Revision | per Electra preset |
| Upstream | electra-preset |
| Driver file | devices/yamaha/tx_81z_base.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/tx_81z_base.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 tx_81z_base: ask “what can the Yamaha TX-81Z base do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (2)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/tx_81z_base/cancel |
11 | 0–127 | continuous | ||
/tx_81z_base/n_a |
6 | 0–127 | continuous |
SysEx commands (77)¶
| OSC address | Arguments |
|---|---|
/tx_81z_base/play_mode |
val: u7 |
/tx_81z_base/fixed_freq |
val: u7 |
/tx_81z_base/fix_range |
val: u7 |
/tx_81z_base/attack |
val: u7 |
/tx_81z_base/max_notes |
val: u7 |
/tx_81z_base/midi_channel |
val: u7 |
/tx_81z_base/volume |
val: u7 |
/tx_81z_base/assign |
val: u7 |
/tx_81z_base/voice_1 |
val: u7 |
/tx_81z_base/voice_2 |
val: u7 |
/tx_81z_base/voice_3 |
val: u7 |
/tx_81z_base/voice_4 |
val: u7 |
/tx_81z_base/voice_5 |
val: u7 |
/tx_81z_base/voice_6 |
val: u7 |
/tx_81z_base/voice_7 |
val: u7 |
/tx_81z_base/voice_8 |
val: u7 |
/tx_81z_base/note_shift |
val: u7 |
/tx_81z_base/note_low |
val: u7 |
/tx_81z_base/note_high |
val: u7 |
/tx_81z_base/perform_select |
val: u7 |
/tx_81z_base/voice_select |
val: u7 |
/tx_81z_base/perform_edit |
val: u7 |
/tx_81z_base/voice_edit_i |
val: u7 |
/tx_81z_base/voice_edit_ii |
val: u7 |
/tx_81z_base/operator_1 |
val: u7 |
/tx_81z_base/operator_2 |
val: u7 |
/tx_81z_base/operator_3 |
val: u7 |
/tx_81z_base/operator_4 |
val: u7 |
/tx_81z_base/operator_5 |
val: u7 |
/tx_81z_base/operator_6 |
val: u7 |
/tx_81z_base/output_level |
val: u7 |
/tx_81z_base/freq_coarse |
val: u7 |
/tx_81z_base/freq_fine |
val: u7 |
/tx_81z_base/detune |
val: u7 |
/tx_81z_base/envelope |
val: u7 |
/tx_81z_base/algorithm |
val: u7 |
/tx_81z_base/feedback |
val: u7 |
/tx_81z_base/osc_key_sync |
val: u7 |
/tx_81z_base/mode |
val: u7 |
/tx_81z_base/transpose_c3 |
val: u7 |
/tx_81z_base/master_tune |
val: u7 |
/tx_81z_base/waveform |
val: u7 |
/tx_81z_base/speed |
val: u7 |
/tx_81z_base/delay |
val: u7 |
/tx_81z_base/trigger_mode |
val: u7 |
/tx_81z_base/pitch_mod_depth |
val: u7 |
/tx_81z_base/amp_mod_depth |
val: u7 |
/tx_81z_base/lfo_key_sync |
val: u7 |
/tx_81z_base/step |
val: u7 |
/tx_81z_base/time |
val: u7 |
/tx_81z_base/pitch_mod_sens |
val: u7 |
/tx_81z_base/env_range |
val: u7 |
/tx_81z_base/env_velocity |
val: u7 |
/tx_81z_base/key_rate_scaling |
val: u7 |
/tx_81z_base/pitch_env |
val: u7 |
/tx_81z_base/velocity |
val: u7 |
/tx_81z_base/amp_mod_sens |
val: u7 |
/tx_81z_base/eg |
val: u7 |
/tx_81z_base/eg_copy |
val: u7 |
/tx_81z_base/no |
val: u7 |
/tx_81z_base/yes |
val: u7 |
/tx_81z_base/op_1_select |
val: u7 |
/tx_81z_base/op_2_select |
val: u7 |
/tx_81z_base/op_3_select |
val: u7 |
/tx_81z_base/op_4_select |
val: u7 |
/tx_81z_base/op_5_select |
val: u7 |
/tx_81z_base/op_6_select |
val: u7 |
/tx_81z_base/range |
val: u7 |
/tx_81z_base/pitch_mod |
val: u7 |
/tx_81z_base/amp_mod |
val: u7 |
/tx_81z_base/eg_bias |
val: u7 |
/tx_81z_base/pitch_bias |
val: u7 |
/tx_81z_base/key_left_curve |
val: u7 |
/tx_81z_base/key_left_depth |
val: u7 |
/tx_81z_base/break_point |
val: u7 |
/tx_81z_base/key_right_curve |
val: u7 |
/tx_81z_base/key_right_depth |
val: u7 |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /tx_81z_base/note/on <note> <velocity>, /tx_81z_base/cc/<number> <value>, /tx_81z_base/pitchbend <0-16383>, /tx_81z_base/program_change <n>.
Limitations¶
Imported from an Electra One community preset. The mapping reflects the preset author's editorial choices: parameter naming, ranges, and which params are exposed. Untested on hardware in this repo.