Teenage Engineering OP-Z: MIDI CC, NRPN and OSC map¶
The Teenage Engineering OP-Z as named OSC addresses — 48 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Teenage Engineering OP-Z |
|---|---|
| Vendor | Teenage Engineering |
| OSC prefix | /op_z |
| 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/teenage-engineering/op_z.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/teenage-engineering/op_z.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 op_z: ask “what can the Teenage Engineering OP-Z do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (48)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/op_z/absolute_parameters/parameter_1_absolute |
1 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/parameter_2_absolute |
2 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/filter_cutoff_absolute |
3 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/filter_resonance_absolute |
4 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/envelope_attack_absolute |
5 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/envelope_decay_absolute |
6 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/envelope_sustain_absolute |
7 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/envelope_release_absolute |
8 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/lfo_depth_absolute |
9 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/lfo_speed_absolute |
10 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/lfo_target_absolute |
11 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/lfo_shape_absolute |
12 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/fx_1_send_absolute |
13 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/fx_2_send_absolute |
14 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/pan_absolute |
15 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/volume_absolute |
16 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/portamento_absolute |
17 | 0–127 | continuous | Absolute parameters | |
/op_z/absolute_parameters/note_style_absolute |
18 | 0–127 | continuous | Absolute parameters | |
/op_z/relative_parameters/parameter_1_relative |
32 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/parameter_2_relative |
33 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/filter_cutoff_relative |
34 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/filter_resonance_relative |
35 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/envelope_attack_relative |
36 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/envelope_decay_relative |
37 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/envelope_sustain_relative |
38 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/envelope_release_relative |
39 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/lfo_depth_relative |
40 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/lfo_speed_relative |
41 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/lfo_target_relative |
42 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/lfo_shape_relative |
43 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/fx_1_send_relative |
44 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/fx_2_send_relative |
45 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/pan_relative |
46 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/volume_relative |
47 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/portamento_relative |
48 | 1–127 | continuous | Relative parameters | |
/op_z/relative_parameters/note_style_relative |
49 | 1–127 | continuous | Relative parameters | |
/op_z/system/track_gain_absolute |
50 | 0–127 | continuous | System | |
/op_z/system/track_gain_relative |
51 | 1–127 | continuous | System | |
/op_z/system/reset_track_gains |
52 | 0–127 | continuous | System | |
/op_z/system/mute |
53 | 0–1 | switch | System | |
/op_z/system/audio_mute |
54 | 0–1 | switch | System | |
/op_z/system/mute_group |
55 | 0–9 | continuous | System | |
/op_z/system/tempo |
56 | 0–127 | continuous | System | |
/op_z/system/swing |
57 | 0–127 | continuous | System | |
/op_z/track/step_count |
60 | 1–16 | continuous | Track | |
/op_z/track/step_length |
61 | 1–16 | continuous | Track | |
/op_z/track/quantize |
62 | 1–16 | continuous | Track | |
/op_z/track/note_length |
63 | 1–16 | continuous | Track |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /op_z/note/on <note> <velocity>, /op_z/cc/<number> <value>, /op_z/pitchbend <0-16383>, /op_z/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.