M-VAVE FM-1: MIDI CC, NRPN and OSC map¶
The M-VAVE FM-1 as named OSC addresses — 56 CC, 2 SysEx commands — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | M-VAVE FM-1 |
|---|---|
| Vendor | M-VAVE |
| OSC prefix | /fm1 |
| Source | 📘 From the manufacturer's documentation |
| Firmware | sidou-0.3.1 |
| Revision | SIDOU 0.3.1 (alternative firmware by Denis Sablić) |
| Upstream | vendor-doc |
| Driver file | devices/m-vave/fm-1.vendor.fw-sidou-0.3.1.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.
Other variants of this device: fm-1.vendor.fw-15, fm-1.vendor.fw-16, fm-1.vendor.fw-386dx-1.0.2, fm-1.vendor.fw-amb-1.3, fm-1.vendor.fw-beetle-1.4.25, fm-1.vendor.fw-bunker-1.0.0, fm-1.vendor.fw-bytemania-1.2.0, fm-1.vendor.fw-carnac-0.9.3, fm-1.vendor.fw-chipbox-1.2.4, fm-1.vendor.fw-choralroot-0.26.1, fm-1.vendor.fw-chord-0.3, fm-1.vendor.fw-clipper-1.1-experimental, fm-1.vendor.fw-coralflower-0.5, fm-1.vendor.fw-cs1-2026.10.22, fm-1.vendor.fw-ctl-1.0, fm-1.vendor.fw-cutador-1.2.1, fm-1.vendor.fw-dinghy-0.4, fm-1.vendor.fw-drift-0.8, fm-1.vendor.fw-dub-1.3.0, fm-1.vendor.fw-duell-1.0, fm-1.vendor.fw-emb-1.5.2, fm-1.vendor.fw-etch-1.61, fm-1.vendor.fw-fart-1.1.0, fm-1.vendor.fw-felucca-1.6.1, fm-1.vendor.fw-felucca-salt-0.9-salt14, fm-1.vendor.fw-felucca8-1.6.1-and-sequences, fm-1.vendor.fw-fimba-0.6.1, fm-1.vendor.fw-flyfish-1.0.1-4e5efb8, fm-1.vendor.fw-fm106-beta4, fm-1.vendor.fw-fm1gm-1.0.2, fm-1.vendor.fw-fmel-1.0, fm-1.vendor.fw-fmini-1.8.0, fm-1.vendor.fw-fomajam-0.1.6, fm-1.vendor.fw-fomni-0.4, fm-1.vendor.fw-frasil-1.0, fm-1.vendor.fw-frodhes-0.9.4, fm-1.vendor.fw-fumi-1.1.0, fm-1.vendor.fw-gammawave-1.0-gw, fm-1.vendor.fw-ghoulbox-2.3.2, fm-1.vendor.fw-golana-1.2, fm-1.vendor.fw-golanadz-0.1.0-beta, fm-1.vendor.fw-grimm-1.0, fm-1.vendor.fw-hera-1.1, fm-1.vendor.fw-hortator-0.23.3, fm-1.vendor.fw-hyp1-1.5.54, fm-1.vendor.fw-jangada-1.0.1, fm-1.vendor.fw-jiant-0.9.9-beta4a-813869d, fm-1.vendor.fw-kawa-0.5, fm-1.vendor.fw-ketch-0.1-beta, fm-1.vendor.fw-loom-0.7, fm-1.vendor.fw-maku-1.0, fm-1.vendor.fw-mc1-1.2.0, fm-1.vendor.fw-melodee-1.4.5, fm-1.vendor.fw-min1-0.2.1, fm-1.vendor.fw-minitone-1.0.2, fm-1.vendor.fw-modelar-0.3, fm-1.vendor.fw-monk-0.9.1, fm-1.vendor.fw-morpheus-1.0.0, fm-1.vendor.fw-mutable-1.0, fm-1.vendor.fw-mycelium-1.0-test, fm-1.vendor.fw-niagara-0.2, fm-1.vendor.fw-nmsfm-0.5, fm-1.vendor.fw-noizdemons-666, fm-1.vendor.fw-obervave-3.0.1, fm-1.vendor.fw-open-14, fm-1.vendor.fw-opn1-2.0.0, fm-1.vendor.fw-orbit-0.7.1, fm-1.vendor.fw-pigeon-0.5.0-beta.1, fm-1.vendor.fw-polly-0.5, fm-1.vendor.fw-purplemonkey-0.11, fm-1.vendor.fw-quest-38, fm-1.vendor.fw-rainbow-1.1.5-rb, fm-1.vendor.fw-shineon-3.0.1, fm-1.vendor.fw-sid-0.1, fm-1.vendor.fw-sid1-1.0.0, fm-1.vendor.fw-skiff-1.4, fm-1.vendor.fw-sloop-2.8.1, fm-1.vendor.fw-sloop-alg-alg05-test, fm-1.vendor.fw-sloop-banks-2.5-b28-test, fm-1.vendor.fw-sloop-floyd-2.4, fm-1.vendor.fw-sloopdx-4.0, fm-1.vendor.fw-tessera-2.0.1, fm-1.vendor.fw-tonitor-2026.10.23, fm-1.vendor.fw-tribe-0.3-beta, fm-1.vendor.fw-tuna-1.0-fbc56d3, fm-1.vendor.fw-unholy-0.2.3, fm-1.vendor.fw-vector37-0.3.2, fm-1.vendor.fw-waveloop-1.0.5.2-midi23, fm-1.vendor.fw-winampfm-0.12, fm-1.vendor.fw-x0x-1.1.0, fm-1.vendor.fw-x0xrmx-1.1.0, fm-1.vendor.fw-zen-1.2, fm-1.vendor.fw-zp12-2.5.
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/m-vave/fm-1.vendor.fw-sidou-0.3.1.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 fm1: ask “what can the M-VAVE FM-1 do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (56)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/fm1/bank_select_msb |
0 | 0–127 | continuous | Track | |
/fm1/mod_wheel_pulse_width |
1 | 0–127 | continuous | Track | |
/fm1/data_entry_msb |
6 | 0–127 | continuous | Track | |
/fm1/volume |
7 | 0–127 | continuous | Track | |
/fm1/waveform |
20 | 0–127 | continuous | Track | |
/fm1/ring_mod |
21 | 0–127 | continuous | Track | |
/fm1/sync |
22 | 0–127 | continuous | Track | |
/fm1/filter_mode |
23 | 0–127 | continuous | Track | |
/fm1/filter_routing |
24 | 0–127 | continuous | Track | |
/fm1/chip_model |
25 | 0–127 | continuous | Track | |
/fm1/envelope_mode |
26 | 0–127 | continuous | Track | |
/fm1/chord_arp_on_off |
27 | 0–127 | continuous | Track | |
/fm1/chord_arp_rate |
28 | 0–127 | continuous | Track | |
/fm1/chord_arp_order |
29 | 0–127 | continuous | Track | |
/fm1/chord_arp_span |
30 | 0–127 | continuous | Track | |
/fm1/bank_select_lsb |
32 | 0–127 | continuous | Track | |
/fm1/data_entry_lsb |
38 | 0–127 | continuous | Track | |
/fm1/resonance |
71 | 0–127 | continuous | Track | |
/fm1/release |
72 | 0–127 | continuous | Track | |
/fm1/attack |
73 | 0–127 | continuous | Track | |
/fm1/cutoff |
74 | 0–127 | continuous | Track | |
/fm1/decay |
75 | 0–127 | continuous | Track | |
/fm1/vibrato_rate |
76 | 0–127 | continuous | Track | |
/fm1/vibrato_depth |
77 | 0–127 | continuous | Track | |
/fm1/vibrato_delay |
78 | 0–127 | continuous | Track | |
/fm1/sustain |
79 | 0–127 | continuous | Track | |
/fm1/chip_profile |
85 | 0–127 | continuous | Track | |
/fm1/age_heat |
86 | 0–127 | continuous | Track | |
/fm1/dac_sloppiness |
87 | 0–127 | continuous | Track | |
/fm1/output_thump |
89 | 0–127 | continuous | Track | |
/fm1/filter_bleed |
90 | 0–127 | continuous | Track | |
/fm1/increment |
96 | 0–127 | continuous | Track | |
/fm1/decrement |
97 | 0–127 | continuous | Track | |
/fm1/nrpn_lsb |
98 | 0–127 | continuous | Track | |
/fm1/nrpn_msb |
99 | 0–127 | continuous | Track | |
/fm1/rpn_lsb |
100 | 0–127 | continuous | Track | |
/fm1/rpn_msb |
101 | 0–127 | continuous | Track | |
/fm1/distortion_algorithm |
102 | 0–127 | continuous | Track | |
/fm1/distortion_amount |
103 | 0–127 | continuous | Track | |
/fm1/distortion_a |
104 | 0–127 | continuous | Track | |
/fm1/distortion_b |
105 | 0–127 | continuous | Track | |
/fm1/distortion_mix |
106 | 0–127 | continuous | Track | |
/fm1/modulation_algorithm |
107 | 0–127 | continuous | Track | |
/fm1/modulation_amount |
108 | 0–127 | continuous | Track | |
/fm1/modulation_a |
109 | 0–127 | continuous | Track | |
/fm1/modulation_b |
110 | 0–127 | continuous | Track | |
/fm1/modulation_mix |
111 | 0–127 | continuous | Track | |
/fm1/fx_algorithm |
112 | 0–127 | continuous | Track | |
/fm1/fx_amount |
113 | 0–127 | continuous | Track | |
/fm1/fx_a |
114 | 0–127 | continuous | Track | |
/fm1/fx_b |
115 | 0–127 | continuous | Track | |
/fm1/fx_mix |
116 | 0–127 | continuous | Track | |
/fm1/output_spread |
117 | 0–127 | continuous | Track | |
/fm1/all_sound_off |
120 | 0–127 | trigger | Track | |
/fm1/reset_controllers |
121 | 0–127 | trigger | Track | |
/fm1/all_notes_off |
123 | 0–127 | trigger | Track |
SysEx commands (2)¶
| OSC address | Arguments |
|---|---|
/fm1/program |
program: u7 |
/fm1/system/identify |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /fm1/note/on <note> <velocity>, /fm1/cc/<number> <value>, /fm1/pitchbend <0-16383>, /fm1/program_change <n>.
Limitations¶
SIDOU 0.3.1 by Denis Sablić (GPL-3.0), a instrument firmware for the FM-1. Source CMake project VERSION 0.4.0 vs 0.3.1 listed; CC64 sustain not handled; Same CC numbers on every channel, TRS and USB. Channels: Modes (MIDI page, channel N): OMNI default (all channels play the live instrument); LIVE (ch N only); MULTI (N.N+2 chip A voices 1-3 as GoatTracker jam voices, N+3 instrument on chip B); WHOLE A (N chip A poly/chord/arp, N+3 chip B); WHOLE B (N chip B). USB and TRS merged. Pitch bend: 14-bit, default +-2 st, 0-24 via RPN 0 (channel, kept over PC) or NRPN 6/0 (preset). Aftertouch: channel and polyphonic; target per preset NRPN 6/3: off (default), vibrato depth, pulse width, cutoff. Clock: in TRS+USB merged: F8, FA, FB, FC, F2 SPP, F3 song select; CLOCK AUTO/FOLLOW/OFF; chord arp follows clock. Out USB only (CLOCK OUT on, no clock in): F8 24 ppqn, FA, FC, F2+FB on resume. MIDI out: USB only (cable 0), channel 1 (build option): panel parameter changes as map CCs (or NRPN hi-res option), presets as PC (+CC0/32), learned CCs; no echo of MIDI input, no thru; clock as above. NRPN: Every live parameter: MSB 0 performance (0 cutoff,1 res,2 PW,3 volume,4 spread), 1 SID (0-10), 2 character (0-4 macros, 5-18 expert), 3-5 effect slots (0-4), 6 expression (0 bend range,1 velocity target,2 mod-wheel target,3 aftertouch target,4-6 vibrato); value MSB*128+LSB, CC38 applies; RPN 0/0 bend range; null 127/127. SysEx `F0 7D 53 44`: SIDOU protocol v1: 01 INQ, 02 DIR, 03 GET, 04 PUT, 05 DATA, 06 END, 07 DEL, 08 ABORT, 7E ACK, 7F NAK (file store; TRS PUT/DATA/END/ABORT only). SysEx `F0 7E \<7F|00> 06 01`: Universal Identity Request -> F0 7E 7F 06 02 7D 53 44 01 00 \<4 version bytes> F7, USB only. SysEx `F0 00 59 (pack7)`: M-UPGRADE vendor update protocol (F0 pack7(00 59 cmd .) F7; cmd 0x11 handshake answers package identity; F0 22 24 35 7F F7 upgrade; F0 22 24 35 7D F7 UBOOT). SysEx `F0 43`: no raw DX7 F0 43 parser. Identity: vendor identify FM-1_900 dev builds, FM-1_964 release tags (platform/fm1/CMakeLists.txt:27, .github/workflows/ci.yml:33); Universal Identity manuf 7D family 53 44 'SD'; USB product 'SIDOU FM-1' (usb_config.h:32).
Try it in your browser
Play a virtual FM-1 with any of its community firmwares: M-VAVE FM-1.