SynthHub
Written from devices/m-vave/fm-1.vendor.fw-ctl-1.0.json, updated 2026-10-24Edit on GitHubJSONCSVMIDNAMOSCQuery

M-VAVE FM-1 running CTL-1 1.0

The M-VAVE FM-1 MIDI implementation: 18 CC, 2 SysEx commands, each named, for Claude (MCP), SuperCollider or any OSC app.

  • sourcemaker's documentation
  • firmwarectl-1.0
Maker
M-VAVE
Firmware
CTL-1 1.0 (alternative firmware by charlesvestal)
Source
maker's documentation
README.mdfrom the author's repository; not claimed yet, anyone can improve it

From the README of charlesvestal/fm1-ctl at e181b4a, licence MPL-2.0.

CTL-1 for the M-VAVE FM-1

CTL-1 turns the M-VAVE FM-1 into a MIDI controller. The keys play notes, with velocity and aftertouch read from the keys themselves, in any scale with its chords under the black keys; the knobs send controllers in four banks; an arpeggiator and a four-track Euclidean drum sequencer run on its clock. Everything goes out over USB and Bluetooth, MIDI from the TRS jack is passed along, and the FM-1 plays it all on its own General MIDI sounds too, so it works with nothing connected.

Installing it is at your own risk, though it's hard to get stuck: the web installer can put M-VAVE's own firmware back, and an FM-1 that fails to start twice comes up in a safe mode the installer can reach.

In short

Keys Notes; with a scale, its notes on the white keys and its chords on the black keys
KNOB 1–4 The page's four values; on Play, four controllers in four banks
HOME · SEL · ARP · SEQ · EDIT · GLO The pages: Play, Keys, Arp, Sequencer, Sound, Setup
SELECT The page's own pages: the banks on Play, the tracks on the Sequencer
ALGORITHM · PRESETS · MASTER MIDI channel · program change (the sound follows) · volume
FX The next bank; held, KNOB 1–4 set its controller numbers
ENV · LFO Sustain (tap twice to lock) · mod wheel
PLAY · REC · SAVE Start / stop · panic · save
OCT− / OCT+ An octave down or up

The manual has the rest.

Screen reader

CTL-1 tells the FM-1 Screen Reader what its screen shows, over USB: the page and its knobs, a knob's value as it turns (a controller with its name, "CC 74 cutoff 64"), the channel and the program, the Sequencer's steps and mutes, the Touch settings, play and stop, and what each button did (the notes you play are not read out). Open the page in Chrome with the FM-1 plugged in; it speaks with its own voice, or hands the text to your computer's screen reader. The reader's messages stay between it and CTL-1: they are never passed on to Bluetooth.

Read the whole README on GitHub

Try it in your browser

Play a virtual FM-1 with any of its community firmwares: M-VAVE FM-1.

Communities

Where M-VAVE FM-1 owners meet, share and help each other:

MIDI controls

20 controls, from the source at CTL-1 1.0 (alternative firmware by charlesvestal)

Track

Control CC Range Name to send
Modulation 1 0–127 /fm1_ctl/modulation
Volume 7 0–127 /fm1_ctl/volume
General 16 0–127 /fm1_ctl/general
General 17 17 0–127 /fm1_ctl/general_17
General 18 18 0–127 /fm1_ctl/general_18
General 19 19 0–127 /fm1_ctl/general_19
General 20 20 0–127 /fm1_ctl/general_20
General 21 21 0–127 /fm1_ctl/general_21
General 22 22 0–127 /fm1_ctl/general_22
General 23 23 0–127 /fm1_ctl/general_23
Sustain 64 switch /fm1_ctl/sustain
Resonance 71 0–127 /fm1_ctl/resonance
Release 72 0–127 /fm1_ctl/release
Attack 73 0–127 /fm1_ctl/attack
Cutoff 74 0–127 /fm1_ctl/cutoff
Decay 75 0–127 /fm1_ctl/decay
Vibrato 76 0–127 /fm1_ctl/vibrato
All notes off 123 trigger /fm1_ctl/all_notes_off

SysEx commands

Command Arguments Name to send
Program program: u7 /fm1_ctl/program
System identify /fm1_ctl/system/identify

Performance MIDI

Notes, pitch bend and any CC are also available: /fm1_ctl/note/on <note> <velocity>, /fm1_ctl/cc/<number> <value>, /fm1_ctl/pitchbend <0-16383>, /fm1_ctl/program_change <n>.

JSON

Use 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 m-vave/fm-1.vendor.fw-ctl-1.0 --out-port <N> --in-port <M>

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /fm1_ctl/modulation 63

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

Limitations

CTL-1 1.0 by charlesvestal (MPL-2.0), a controller firmware for the FM-1. Licence MPL-2.0, not GPL-3.0. Channels: Out: keyboard channel set by ALGORITHM (default ch1); Euclidean drum sequencer on Seq ch (default ch10). In: all channels thru to the onboard GM synth (all 16 parts, drums ch10) unless Sound page MIDI in = Ignored. Pitch bend: Not sent. In: onboard EAS 14-bit bend, default +-2 st, RPN0 sets range (RPN1/2 tuning). Aftertouch: Out: poly aftertouch per note (default) or channel pressure from the key sensors (Touch page). In: EAS uses channel pressure as modulation; poly pressure ignored. Clock: Int (default): sends F8 24 ppqn over USB (BLE while running) and FA/FC on PLAY; Int quiet: FA/FC only; Ext: follows F8/FA/FB/FC from USB/TRS/BLE. Tempo 40-240. No SPP. MIDI out: USB + Bluetooth MIDI (BLE peripheral 'FM-1' and central to BLE devices): keys (fixed or sensed velocity, scale/chord mapping), CCs, PC, aftertouch, arp, Euclidean drums, clock. Thru: USB->BLE, BLE->USB, TRS->USB+BLE; channel + realtime messages, no SysEx. Onboard Sonivox EAS GM synth (128 GM + drum kit ch10, 24 voices) plays what it sends and what comes in. NRPN: none sent; onboard EAS ignores NRPN. CCs without a fixed number: MASTER knob CC (out: optional, Sound page sets a CC number (0 = MASTER is the onboard volume)); incoming CC on keyboard channel (in: a CC matching a bank knob's number updates that knob's stored value (follow)). 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 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_6010000 for release 1.0 (FM-1_600 dev build); USB product "CTL-1 FM-1"; editor INFO: none (no F0 7D 46 4C handler); Universal Identity: none; BLE name FM-1; also ctl-usb-X.Y.fwsc build without BLE.

Firmwares

The M-VAVE FM-1 runs 94 firmwares SynthHub maps, each with its own MIDI or another's it shares. All the devices with several: firmwares.

94 firmwares
Firmware From Licence MIDI Sounds
386DX 1.0.2 github.com/seajaysec its own
AMB-1 1.3 github.com/charlesvestal its own
BEETLE 1.4.25 github.com/SikkenWorks its own
Bunker Evolved 1.0.0 github.com/kidbee85-beep its own
Bytemania 1.2.0 github.com/llozd its own
Carnac OS 0.9.3 github.com/OwenKirby its own
Chipbox 1.2.4 github.com/pbarilla its own
ChoralRoot 0.26.1 github.com/Quixotic7 its own 42
Clipper 1.1-experimental github.com/isod89 its own 405
CoralFlower 0.5 github.com/FicusFicusov its own
CS-1 2026.10.22 github.com/twochannels its own
CTL-1 1.0 github.com/charlesvestal its own
Cut-A-Dor 1.2.1 github.com/kidbee85-beep its own
Dinghy 0.4 github.com/zvenson its own
DRIFT 0.8 github.com/FBNFRTG its own
DUB-1 1.3.0 github.com/sbegueria its own
DUELL 1.0 github.com/oscillr its own 128
ETCH 1.61 github.com/SikkenWorks its own
Evander's Music Box 1.5.2 github.com/MikeTsak its own
Fart Machine One 1.1.0 github.com/adamcharleswilsonmusic-code its own
Felucca 1.6.1 github.com/hugelton its own 60
Felucca 8 Patterns 1.6.1_and_sequences github.com/echoe its own
Felucca [Salt] 0.9-salt14 github.com/ChanceTheMaker its own
FiMba-1 0.6.1 github.com/jadamsowers its own
Flyfish 1.0.1-4e5efb8 github.com/delirioux its own
FM-1 SID 0.1 github.com/joakimeriksson same as Bytemania 1.2.0
FM-106 Beta4 github.com/PatttF its own 192
FM1 Open V14 github.com/m-vave its own
FM1 Quest 38 github.com/hericdk same as Dinghy 0.4
fm1-chord 0.3 github.com/math0ne its own
FM1-GM 1.0.2 github.com/jartificer its own
FMEL-1 1.0 github.com/AntonioAltea its own
FMini-1 1.8.0 github.com/ruppert its own
FOMAJAM 0.1.6 github.com/konsumer its own
FoMni 0.4 github.com/charlesvestal same as DUB-1 1.3.0
FRASIL 1.0 github.com/styvesgoupil its own
Frodhes 0.9.4 github.com/leonardoMirabal its own
FuMi-1 1.1.0 github.com/cartesive its own
GHOULBOX 2.3.2 github.com/jasonpersinger its own 53
Golana 1.2 github.com/Gadlele its own
Golana DZ Edition 0.1.0-beta github.com/dzwerg its own
GR!MM 1.0 github.com/GRiMMBIENT same as Dinghy 0.4
HERA 1.1 github.com/benbadio its own
Hortator 0.23.3 github.com/DeadActive same as Dinghy 0.4
HYP-1 1.5.54 github.com/RustyPawz its own
Jangada 1.0.1 github.com/zednaked its own 191
JIANT FM 0.9.9-beta4a-813869d github.com/juanjiant-bit its own 131
KAWA 0.5 github.com/Guizmoh same as Bytemania 1.2.0
Ketch 0.1-beta github.com/risseraka same as Bytemania 1.2.0
LOOM-8 0.7 github.com/charlesvestal its own
MAKU 1.0 github.com/okumurari2 its own
MC-1 1.2.0 github.com/dspaudio its own
Melodee 1.4.5 github.com/keremimo its own
MIN-1 0.2.1 github.com/Reytian its own
Mini-Tone 1.0.2 github.com/eldontyrellcorp its own
MODELAR 0.3 github.com/hirakos999 its own
MONK-1 0.9.1 github.com/charlesvestal its own
MORPHEUS 1.0.0 github.com/benbadio its own
Mutable Dreams 1.0 github.com/kidbee85-beep same as DUB-1 1.3.0
MYCELIUM 1.0-test github.com/megagott same as Dinghy 0.4
Niagara Drift 0.2 github.com/evanyerburgh same as DUB-1 1.3.0
No Man Sky FM 0.5 github.com/hericdk its own
NOIZ DEMONS 666 github.com/SPIKE-the-Percussionist same as Felucca 8 Patterns 1.6.1_and_sequences
OberVave 3.0.1 github.com/zvenson its own
OPN-1 2.0.0 github.com/putchdev its own
ORBIT 0.7.1 github.com/dspaudio its own
PIGEON 0.5.0-beta.1 github.com/TheShrimpBlimp its own
Pocket GammaWave 1.0-GW github.com/fvalente its own
Polly 0.5 github.com/charlesvestal its own
PurpleMonkey 0.11 github.com/Quixotic7 its own
Rainbow Mode 1.1.5-rb github.com/joshbartlettband-web its own
Shine On 3.0.1 github.com/zvenson its own
SID-1 1.0.0 github.com/putchdev its own
SIDOU 0.3.1 github.com/dsablic its own
Skiff 1.4 github.com/illuminus5 its own
SLOOP 2.8.1 github.com/isod89 its own 153
SLOOP ALG ALG05-TEST github.com/shaw-core same as Dinghy 0.4
SLOOP DX7 Banks 2.5-b28-test github.com/majnikool its own
SLOOP Floyd FM 2.4 github.com/renebohne same as Dinghy 0.4
sloopDX 4.0 github.com/zvenson its own
stock firmware V15 m-vave.com its own
stock firmware V16 m-vave.com its own
Tessera 2.0.1 github.com/Rastapopolix its own
Tonitor 2026.10.23 github.com/nzimas its own
TRIBE 0.3-beta github.com/apiel same as Dinghy 0.4
Tuna 1.0-fbc56d3 github.com/delirioux its own
Unholy Union 0.2.3 github.com/actuallysparky its own
Vector37 0.3.2 github.com/genkigenki its own
WaveLoop FM-1 1.0.5.2-midi23 github.com/ELI7VH its own
winampFM Synth 0.12 github.com/hericdk its own
X0X 1.1.0 github.com/charlesvestal same as Dinghy 0.4
X0X-RMX 1.1.0 github.com/Mr-Roboto same as Dinghy 0.4
ZEN-1 1.2 github.com/aceyprime its own
zp12 2.5 github.com/zvenson its own

Frequently asked questions

Which MIDI CC controls the filter cutoff on the M-VAVE FM-1?

CC 74 (0–127), named /fm1_ctl/cutoff in SynthHub's map.

How many parameters of the M-VAVE FM-1 can be controlled over MIDI?

SynthHub's map of the M-VAVE FM-1 lists 18 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.

Can an AI agent like Claude control the M-VAVE FM-1?

Yes: SynthHub's hosted MCP server knows the M-VAVE FM-1's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.