Skip to content

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:

osc-bridge osc-send /akai_z8/1_cc74 63

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.