Skip to content

IK Multimedia ToneX Pedal: MIDI CC, NRPN and OSC map

The IK Multimedia ToneX Pedal as named OSC addresses — 39 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.

Device IK Multimedia ToneX Pedal
Vendor IK Multimedia
OSC prefix /tonex_pedal
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/ik-multimedia/tonex_pedal.pencilresearch.fw-unknown.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/ik-multimedia/tonex_pedal.pencilresearch.fw-unknown.json --out-port <N> --in-port <M>

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /tonex_pedal/banks_and_presets/midi_patch_bank 0

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

MIDI CC and NRPN parameters (39)

OSC address CC NRPN (MSB/LSB) Range Nature Section
/tonex_pedal/banks_and_presets/midi_patch_bank 0 0–1 switch Banks and presets
/tonex_pedal/banks_and_presets/preset_on_off 12 0–127 continuous Banks and presets
/tonex_pedal/pedals/expression_pedal 11 0–127 continuous Pedals
/tonex_pedal/main_parameters/gain 102 0–127 continuous Main parameters
/tonex_pedal/main_parameters/bass 23 0–127 continuous Main parameters
/tonex_pedal/main_parameters/mid 25 0–127 continuous Main parameters
/tonex_pedal/main_parameters/treble 28 0–127 continuous Main parameters
/tonex_pedal/alternative_parameters/reverb 79 0–127 continuous Alternative parameters
/tonex_pedal/alternative_parameters/compressor 19 0–127 continuous Alternative parameters
/tonex_pedal/alternative_parameters/noise_gate 15 0–127 continuous Alternative parameters
/tonex_pedal/alternative_parameters/presence 106 0–127 continuous Alternative parameters
/tonex_pedal/alternative_parameters/depth 107 0–127 continuous Alternative parameters
/tonex_pedal/additional_parameters/model_volume 103 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/noise_gate_threshold 14 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/noise_gate_release 16 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/noise_gate_depth 17 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/compressor 18 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/compressor_gain 20 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/compressor_attack 21 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/compressor_patch 22 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/bass_frequency 24 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mid_q 26 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mid_frequency 27 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/treble_frequency 29 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/eq_patch 30 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb_mix 104 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb 75 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb_type 85 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb_time 76 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb_pre_delay 77 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/reverb_color 78 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/cabinet_resonance 108 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_1 109 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_1_x_position 110 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_1_z_position 111 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_2 112 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_2_x_position 113 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mic_2_z_position 114 0–127 continuous Additional parameters
/tonex_pedal/additional_parameters/mics_mix 115 0–127 continuous Additional parameters

Performance MIDI

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