M-VAVE FM-1: MIDI CC, NRPN and OSC map¶
The M-VAVE FM-1 as named OSC addresses — 45 CC, 3 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 | loom-0.7 |
| Revision | LOOM-8 0.7 (alternative firmware by Charles Vestal) |
| Upstream | vendor-doc |
| Driver file | devices/m-vave/fm-1.vendor.fw-loom-0.7.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-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-sidou-0.3.1, 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-loom-0.7.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 (45)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/fm1/lfo_amount |
1 | 0–127 | continuous | Track | |
/fm1/glide |
5 | 0–127 | continuous | Track | |
/fm1/level |
7 | 0–127 | continuous | Track | |
/fm1/mute |
9 | 0–127 | continuous | Track | |
/fm1/pan |
10 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_1 |
16 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_2 |
17 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_3 |
18 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_4 |
19 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_5 |
20 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_6 |
21 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_7 |
22 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_8 |
23 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_9 |
24 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_10 |
25 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_mute_11 |
26 | 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/kit_sound_1_11_pan_1 |
80 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_2 |
81 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_3 |
82 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_4 |
83 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_5 |
84 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_6 |
85 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_7 |
86 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_8 |
87 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_9 |
88 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_10 |
89 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_pan_11 |
90 | 0–127 | continuous | Track | |
/fm1/send_i |
91 | 0–127 | continuous | Track | |
/fm1/send_ii |
93 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_1 |
102 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_2 |
103 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_3 |
104 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_4 |
105 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_5 |
106 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_6 |
107 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_7 |
108 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_8 |
109 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_9 |
110 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_10 |
111 | 0–127 | continuous | Track | |
/fm1/kit_sound_1_11_level_11 |
112 | 0–127 | continuous | Track |
SysEx commands (3)¶
| OSC address | Arguments |
|---|---|
/fm1/program |
program: u7 |
/fm1/system/info |
|
/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¶
LOOM-8 0.7 by Charles Vestal (GPL-3.0), a groovebox firmware for the FM-1. CC numbers echo Felucca's (5/7/10/71-75/91/93) but routing is per channel=track, plus kit/FX/master maps; 9 engines differ from Felucca. Channels: Fixed: tracks T1-T8 = ch1-8, FX I ch9, FX II ch10, master + scenes ch11; ch12-16 play/ccs to the selected instrument track; notes on 9/10 ignored. Never sends on 12-16. Pitch bend: Per track, fixed +-2 semitones, no RPN. Aftertouch: ignored. Clock: In: F8 ext clock, FA start, FB continue, FC stop. Out: F8 24 ppqn + FA/FB/FC when Setup 'clock' send is on and not on ext clock. No SPP. MIDI out: USB: track notes on own channel (track MIDI OUT + Setup NOTES on; keys and sequencer, not echoed MIDI-in or arps they start); CC OUT (on by default): hand-turned mapped knobs as their CC; scene PCs on ch11 with SCENES OUT. NRPN: none. SysEx `F0 00 32 45 00 00 00 40 7F F7`: M-VAVE vendor update protocol kept (felucca-bsp ota.c): identify reply = 27-byte product string (fm1.toml id_prefix + 00 dev / + XXYYZZ release); update, backup and screen mirror commands in the 00 59 framing. SysEx `F0 7D 53 52`: fm1-reader screen-reader protocol (SR): HELLO, page/knob announcements as text. SysEx `F0 7D 4C 47 F7`: development log readout (LG): crash record, rails, as ASCII frames. SysEx `F0 7D 4C 43`: remote panel control (LC): buttons, keys, encoders, master; ack F0 7D 4C 43 op F7. SysEx `F0 7D 46 4C`: Felucca editor framing, LOOM subset: INFO(1) -> 'LOOM-8 \<version>', sample bank SMP_BEGIN.SMP_READ (11-17), PING 25, PROF 26, BENCH 27, SOUND 28; no patch/bank editor commands. SysEx `F0 43`: absent: no DX7 bulk parser; other SysEx dropped. SysEx `F0 7E 7F 06 01`: absent: no Universal Identity reply. Identity: vendor identify: FM-1_10000700 for release 0.7 (FM-1_1000 dev build); USB product "LOOM-8 FM-1"; editor INFO: 'LOOM-8 \<version>'; Universal Identity: none.
Try it in your browser
Play a virtual FM-1 with any of its community firmwares: M-VAVE FM-1.