Akai Z8: MIDI CC, NRPN and OSC map¶
The Akai Z8 as named OSC addresses — 11 CC, 75 SysEx commands — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Akai Z8 |
|---|---|
| Vendor | Akai |
| OSC prefix | /akai_z8 |
| Source | 🎛️ Derived from an Electra One community preset |
| Revision | per Electra preset |
| Upstream | electra-preset |
| Driver file | devices/akai/akai_z8.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/akai/akai_z8.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 akai_z8: ask “what can the Akai Z8 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (11)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/akai_z8/1_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/2_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/3_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/4_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/5_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/6_cc74 |
74 | 0–127 | continuous | ||
/akai_z8/source_midi |
28 | 0–127 | continuous | ||
/akai_z8/source_midi |
29 | 0–127 | continuous | ||
/akai_z8/source_midi |
30 | 0–127 | continuous | ||
/akai_z8/set_dest |
31 | 0–127 | continuous | ||
/akai_z8/depth |
32 | 0–127 | continuous |
SysEx commands (75)¶
| OSC address | Arguments |
|---|---|
/akai_z8/program_screen |
val: u7 |
/akai_z8/sets_curr_kg |
val: u7 |
/akai_z8/sets_to_all |
val: u7 |
/akai_z8/kg_select |
val: u7 |
/akai_z8/prog_no |
val: u7 |
/akai_z8/filter_type |
val: u7 |
/akai_z8/filter_freq |
val: u7 |
/akai_z8/res |
val: u7 |
/akai_z8/amplitude |
val: u7 |
/akai_z8/filter_env |
val: u7 |
/akai_z8/aux_env |
val: u7 |
/akai_z8/lfo_1_2 |
val: u7 |
/akai_z8/rate |
val: u7 |
/akai_z8/depth |
val: u7 |
/akai_z8/waveform |
val: u7 |
/akai_z8/delay |
val: u7 |
/akai_z8/lfo_phase |
val: u7 |
/akai_z8/re_trigger |
val: u7 |
/akai_z8/lfo_sync |
val: u7 |
/akai_z8/midi_sync |
val: u7 |
/akai_z8/sync_value |
val: u7 |
/akai_z8/portamento |
val: u7 |
/akai_z8/mono_legato |
val: u7 |
/akai_z8/porta_time |
val: u7 |
/akai_z8/multi_tempo |
val: u7 |
/akai_z8/prog_monitor |
val: u7 |
/akai_z8/multi_button |
val: u7 |
/akai_z8/slot_no |
val: u7 |
/akai_z8/mod_source |
val: u7 |
/akai_z8/cc_no |
val: u7 |
/akai_z8/destination |
val: u7 |
/akai_z8/key_group |
val: u7 |
/akai_z8/mute_1 |
val: u7 |
/akai_z8/mute_2 |
val: u7 |
/akai_z8/mute_3 |
val: u7 |
/akai_z8/mute_4 |
val: u7 |
/akai_z8/mute_5 |
val: u7 |
/akai_z8/mute_6 |
val: u7 |
/akai_z8/solo_1 |
val: u7 |
/akai_z8/solo_2 |
val: u7 |
/akai_z8/solo_3 |
val: u7 |
/akai_z8/solo_4 |
val: u7 |
/akai_z8/solo_5 |
val: u7 |
/akai_z8/solo_6 |
val: u7 |
/akai_z8/ouputs |
val: u7 |
/akai_z8/volume_1 |
val: u7 |
/akai_z8/volume |
val: u7 |
/akai_z8/pad_toggle |
val: u7 |
/akai_z8/input |
val: u7 |
/akai_z8/effect |
val: u7 |
/akai_z8/ouput |
val: u7 |
/akai_z8/list |
val: u7 |
/akai_z8/6_p_lo_pass |
val: u7 |
/akai_z8/source_midi |
val: u7 |
/akai_z8/dest_freq |
val: u7 |
/akai_z8/cc_74 |
val: u7 |
/akai_z8/a_0 |
val: u7 |
/akai_z8/decay |
val: u7 |
/akai_z8/s_0 |
val: u7 |
/akai_z8/r_0 |
val: u7 |
/akai_z8/freq_0 |
val: u7 |
/akai_z8/d_20 |
val: u7 |
/akai_z8/all_kg |
val: u7 |
/akai_z8/set_to_2_hp |
val: u7 |
/akai_z8/slot_62_cont |
val: u7 |
/akai_z8/slot_63_cont |
val: u7 |
/akai_z8/set_to_2_lp |
val: u7 |
/akai_z8/low_cut |
val: u7 |
/akai_z8/cc_03 |
val: u7 |
/akai_z8/frequency |
val: u7 |
/akai_z8/high_cut |
val: u7 |
/akai_z8/choose_triple |
val: u7 |
/akai_z8/cc_number |
val: u7 |
/akai_z8/plus_1 |
val: u7 |
/akai_z8/minus_1 |
val: u7 |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /akai_z8/note/on <note> <velocity>, /akai_z8/cc/<number> <value>, /akai_z8/pitchbend <0-16383>, /akai_z8/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.