Skip to content

Waldorf microQ: MIDI CC, NRPN and OSC map

The Waldorf microQ as named OSC addresses — 115 CC, 137 SysEx commands — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.

Device Waldorf microQ
Vendor Waldorf
OSC prefix /microq
Source 🎛️ Derived from an Electra One community preset
Revision per Electra preset
Upstream electra-preset
Driver file devices/waldorf/microq.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/waldorf/microq.json --out-port <N> --in-port <M>

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /microq/osc_1_shape 63

From Claude or any MCP client, the osc-bridge mcp server exposes this driver as microq: ask “what can the Waldorf microQ do?” and it reads this map with list_routes. See the MCP guide.

MIDI CC and NRPN parameters (115)

OSC address CC NRPN (MSB/LSB) Range Nature Section
/microq/osc_1_shape 31 0–127 continuous
/microq/osc_1_fm 30 0–127 continuous
/microq/osc_1_semitone 28 -12–12 continuous
/microq/osc_1_pls_wdth 33 0–127 continuous
/microq/osc_1_level 52 0–127 continuous
/microq/ringmod_level 54 0–127 continuous
/microq/osc_1_octave 27 0–127 continuous
/microq/osc_1_detune 29 -64–63 continuous
/microq/osc_1_pwm 34 -64–63 continuous
/microq/osc_1_balance 53 -64–63 continuous
/microq/ringmod_bal 55 0–127 continuous
/microq/osc_2_shape 39 0–127 continuous
/microq/osc_2_fm 38 0–127 continuous
/microq/osc_2_semitone 36 -12–12 continuous
/microq/osc_2_pls_wdth 40 0–127 continuous
/microq/osc_2_level 56 0–127 continuous
/microq/sync 49 0–127 continuous
/microq/osc_2_octave 35 0–127 continuous
/microq/osc_2_detune 37 -64–63 continuous
/microq/osc_2_pwm 41 -64–63 continuous
/microq/osc_2_balance 57 -64–63 continuous
/microq/pitch_mod 50 -64–63 continuous
/microq/osc_3_shape 46 0–127 continuous
/microq/osc_3_fm 45 0–127 continuous
/microq/osc_3_semitone 43 -12–12 continuous
/microq/osc_3_pls_wdth 47 0–127 continuous
/microq/ocs_3_level 58 0–127 continuous
/microq/noise_ext_lvl 60 0–127 continuous
/microq/osc_3_octave 42 0–127 continuous
/microq/osc_3_detune 44 -64–63 continuous
/microq/osc_3_pwm 48 -64–63 continuous
/microq/osc_3_balance 59 -64–63 continuous
/microq/noise_ext_bal 61 -64–63 continuous
/microq/lfo_1_shape 15 0–127 continuous
/microq/lfo_1_speed 16 0–127 continuous
/microq/lfo_2_shape 19 0–127 continuous
/microq/lfo_2_speed 20 0–127 continuous
/microq/lfo_3_shape 23 0–127 continuous
/microq/lfo_3_speed 24 0–127 continuous
/microq/lfo_1_sync 17 0–127 continuous
/microq/lfo_1_delay 18 0–127 continuous
/microq/lfo_2_sync 21 0–127 continuous
/microq/lfo_2_delay 22 0–127 continuous
/microq/lfo_3_sync 25 0–127 continuous
/microq/lfo_3_delay 26 0–127 continuous
/microq/arp_range 12 1–10 continuous
/microq/arp_length 13 1–16 continuous
/microq/arp_mode 14 0–127 continuous
/microq/glide_rate 5 0–127 continuous
/microq/glide_mode 51 0–9 continuous
/microq/glide_off_on 64 0–127 continuous
/microq/mod_wheel 1 0–127 continuous
/microq/breath 2 0–127 continuous
/microq/foot_control 4 0–127 continuous
/microq/channel_volume 7 0–127 continuous
/microq/pan 10 -64–63 continuous
/microq/amp_volume 90 0–127 continuous
/microq/amp_velocity 91 -64–63 continuous
/microq/fx_1_mix 93 0–127 continuous
/microq/sostenuto 66 0–127 continuous
/microq/all_sounds_off 120 0–127 continuous
/microq/all_notes_off 123 0–127 continuous
/microq/amp_mod 92 -64–63 continuous
/microq/fx_2_mix 94 0–127 continuous
/microq/reset_controls 121 0–127 continuous
/microq/filter_1_type 68 0–127 continuous
/microq/flt_1_cutoff 69 0–127 continuous
/microq/filter_1_res 70 0–127 continuous
/microq/filter_1_fm 76 0–127 continuous
/microq/filter_1_pan 77 -64–63 continuous
/microq/keytrack 72 -200–197 continuous
/microq/filter_1_drive 71 0–127 continuous
/microq/env_amount 73 -64–63 continuous
/microq/env_velocity 74 -64–63 continuous
/microq/cutoff_mod 75 -64–63 continuous
/microq/pan_mod 78 -64–63 continuous
/microq/filter_2_type 79 0–127 continuous
/microq/flt_2_cutoff 80 0–127 continuous
/microq/filter_2_res 81 0–127 continuous
/microq/filter_2_fm 87 0–127 continuous
/microq/filter_2_pan 88 -64–63 continuous
/microq/keytrack 83 -200–197 continuous
/microq/filter_2_drive 82 0–127 continuous
/microq/env_amount 84 -64–63 continuous
/microq/env_velocity 85 -64–63 continuous
/microq/cutoff_mod 86 -64–63 continuous
/microq/pan_mod 89 -64–63 continuous
/microq/fltr_attack 95 0–127 continuous
/microq/fltr_decay_1 96 0–127 continuous
/microq/fltr_sust_1 97 0–127 continuous
/microq/fltr_release 100 0–127 continuous
/microq/fltr_decay_2 98 0–127 continuous
/microq/fltr_sust_2 99 0–127 continuous
/microq/amp_attack 101 0–127 continuous
/microq/amp_decay_1 102 0–127 continuous
/microq/amp_sust_1 103 0–127 continuous
/microq/amp_release 106 0–127 continuous
/microq/amp_decay_2 104 0–127 continuous
/microq/amp_sust_2 105 0–127 continuous
/microq/env_3_attack 107 0–127 continuous
/microq/env_3_decay_1 108 0–127 continuous
/microq/env_3_sust_1 109 0–127 continuous
/microq/env_3_release 112 0–127 continuous
/microq/env_3_decay_2 110 0–127 continuous
/microq/env_3_sust_2 111 0–127 continuous
/microq/env_4_attack 113 0–127 continuous
/microq/env_4_decay_1 114 0–127 continuous
/microq/env_4_sust_1 115 0–127 continuous
/microq/env_4_release 118 0–127 continuous
/microq/env_4_decay_2 116 0–127 continuous
/microq/env_4_sust_2 117 0–127 continuous
/microq/hold 64 0–127 continuous
/microq/modwheel 1 0–127 continuous
/microq/filter_1_2 3 0–127 continuous
/microq/resonance_1_2 6 0–127 continuous

SysEx commands (137)

OSC address Arguments
/microq/wave_shape val: u7
/microq/semitone val: u7
/microq/octave val: u7
/microq/detune val: u7
/microq/osc_1 val: u7
/microq/osc_2 val: u7
/microq/osc_3 val: u7
/microq/ring_mod val: u7
/microq/noise_ext val: u7
/microq/f1_mix val: u7
/microq/filter_type val: u7
/microq/speed val: u7
/microq/resonance val: u7
/microq/attack val: u7
/microq/decay val: u7
/microq/sustain val: u7
/microq/release val: u7
/microq/cutoff val: u7
/microq/pulse_width val: u7
/microq/pwm_source val: u7
/microq/fm_source val: u7
/microq/keytrack val: u7
/microq/pw_mod val: u7
/microq/fm_amount val: u7
/microq/bend_range val: u7
/microq/sync_to_osc3 val: u7
/microq/sub_freq_div val: u7
/microq/transpose val: u7
/microq/mono val: u7
/microq/voices val: u7
/microq/sub_volume val: u7
/microq/source val: u7
/microq/amount val: u7
/microq/volume val: u7
/microq/velocity val: u7
/microq/glide val: u7
/microq/glide_mode val: u7
/microq/glide_rate val: u7
/microq/level val: u7
/microq/filter_1_feed val: u7
/microq/filter_balance val: u7
/microq/filter_2_feed val: u7
/microq/mode val: u7
/microq/adsr val: u7
/microq/trig_single val: u7
/microq/attack_level val: u7
/microq/decay_2 val: u7
/microq/sustain_2 val: u7
/microq/drive val: u7
/microq/parallel val: u7
/microq/serial val: u7
/microq/velocity_mod val: u7
/microq/env_mod val: u7
/microq/pan val: u7
/microq/mod_source val: u7
/microq/pan_mod_source val: u7
/microq/cutoff_mod val: u7
/microq/pan_mod_amount val: u7
/microq/sync val: u7
/microq/start_phase val: u7
/microq/fade val: u7
/microq/speed_clckd val: u7
/microq/clocked val: u7
/microq/delay val: u7
/microq/source_1 val: u7
/microq/destination_1 val: u7
/microq/source_3 val: u7
/microq/destination_3 val: u7
/microq/source_2 val: u7
/microq/destination_2 val: u7
/microq/source_4 val: u7
/microq/destination_4 val: u7
/microq/source_5 val: u7
/microq/destination_5 val: u7
/microq/source_7 val: u7
/microq/destination_7 val: u7
/microq/source_6 val: u7
/microq/destination_6 val: u7
/microq/source_8 val: u7
/microq/destination_8 val: u7
/microq/operator val: u7
/microq/constant val: u7
/microq/fx_1_select val: u7
/microq/depth val: u7
/microq/feedback val: u7
/microq/polarity val: u7
/microq/mix val: u7
/microq/post_gain val: u7
/microq/center val: u7
/microq/spacing val: u7
/microq/overdrive val: u7
/microq/chor_delay val: u7
/microq/ring_m_source val: u7
/microq/ring_mod_level val: u7
/microq/sample_hold val: u7
/microq/low_band_level val: u7
/microq/eq_mid_band val: u7
/microq/mid_band_level val: u7
/microq/hi_band_level val: u7
/microq/a_signal val: u7
/microq/a_hi_freq val: u7
/microq/hi_offset val: u7
/microq/bands val: u7
/microq/a_lo_freq val: u7
/microq/s_offset val: u7
/microq/bandwidth val: u7
/microq/fx_2_select val: u7
/microq/link_fx2_to val: u7
/microq/pre_delay val: u7
/microq/lowpass val: u7
/microq/highpass val: u7
/microq/size val: u7
/microq/shape val: u7
/microq/diffusion val: u7
/microq/damping val: u7
/microq/delay_clckd val: u7
/microq/length_clckd val: u7
/microq/tempo val: u7
/microq/length val: u7
/microq/autopan val: u7
/microq/front_l_vol val: u7
/microq/delay_l val: u7
/microq/delay_sur2_l val: u7
/microq/centre_vol val: u7
/microq/delay_r val: u7
/microq/front_r_vol val: u7
/microq/rear_l_vol val: u7
/microq/delay_sur_l val: u7
/microq/low_fe_lp val: u7
/microq/input_hp val: u7
/microq/delay_sur_r val: u7
/microq/rear_r_vol val: u7
/microq/voice_request val: u7
/microq/drum_request val: u7
/microq/glob_request val: u7
/microq/clock val: u7
/microq/arp_send val: u7

Performance MIDI

Notes, pitch bend and any CC are also available: /microq/note/on <note> <velocity>, /microq/cc/<number> <value>, /microq/pitchbend <0-16383>, /microq/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.