1 Welcome and safety
Thank you for trying Lunar Modulator. It is open firmware being written for the M-VAVE FM-1, the pocket six-operator FM synthesizer with 27 keys, eight knobs and a 240 × 240 colour screen. It is designed to give the FM-1 a choice of synthesis engines, up to four sounds at once with effects of their own, a rack of modulation and a sequencer with parameter locks, and every line of its own code is open under the MIT licence.
Lunar Modulator runs today in a web browser and on computers. It does not run on the FM-1 yet. This manual describes what it does, how to play it, and where each part of it stands, including the limits of the device work.
1.1 What you can use today
Lunar Modulator is built and tested on computers first, and each function in this manual carries a status that says where it works today:
In the simulator Works today in the browser simulator.
On the desktop Works today in the desktop tools (fm1-render, fm1-seq).
Planned for the device Designed; not built for the FM-1 yet.
- The browser simulator is a virtual FM-1. The firmware’s engines and effects run in your browser, behind a to-scale drawing of the front panel with the firmware’s own 240 × 240 screen. Play it with the mouse, a touch screen, the computer keyboard or a MIDI keyboard. It is the front page of the project’s website, ip2k.github.io/lunar-modulator, and chapter 2 shows how to use it.
- The desktop tools play the same engines, effects, modulation and sequencer into audio files from the command line. They are how the firmware is tested, and the only place a few of the sequencer’s functions (clips, scenes and songs) run so far.
- The FM-1 itself runs none of it yet. Everything marked Planned for the device is designed and documented, but still needs implementation and verification on the hardware.
1.2 Features at a glance
| Function | Where it works today | Chapter |
|---|---|---|
| Eight sound engines: Macro, Macro Heavy, Six-Op FM, FM6, Shapes, Sophie, Drums and Test Sine, up to four sounds at once | Simulator, desktop | 5 |
| Twenty-four effects: two inserts on each sound and two on the master bus, followed by a limiter | Simulator, desktop | 6 |
| The front panel: the knobs, the keys, the screen and every button but SAVE | Simulator | 3 |
| Octave, transpose, velocity and pitch bend | Simulator; velocity and bend also on the desktop | 4 |
| Notes from a MIDI keyboard | Simulator | 9 |
| Sequencer: steps, parameter locks, conditions, recording, Capture, eight tracks | Simulator, desktop | 7 |
| Sequencer clips, scenes and songs | Desktop | 7 |
| Modulation: LFOs, envelopes and fourteen more modules, cabled to any parameter | Simulator, desktop | 8 |
| Sequencer sets saved and loaded as text files | Desktop | 10 |
| Any of the above on the FM-1 | Planned | 11 |
1.3 Device work and recovery
The owner has authorized staged bench work on their own FM-1. In October 2026
an interrupted install left that unit unable to start. On 26 October 2026 the
project brought it back to M-VAVE’s firmware V15 through the processor’s USB
recovery mode, with a Raspberry Pi Pico 2 W: two matching full backups, a
rewrite that was read back and checked, and a unit that starts again and
identifies as FM-1_015. So an FM-1 that will not start can be returned to
M-VAVE’s firmware, as long as the small boot area at the start of its memory
is intact. A damaged boot area, putting back a unit’s own earlier firmware,
and installing Lunar remain untested.
The FM-1’s own updater runs inside the installed firmware, so it cannot rescue an application that no longer starts; the recovery route can. Before any further erase or program operation, the staged plan requires private backups to be compared, the exact image and ranges to be reviewed, and a recovery plan and a way back to recovery mode to be kept. Reaching recovery mode alone does not prove that a unit can be recovered. The route, its limits and the safeguards are in chapter 11.
There is nothing to install on your FM-1 yet
There is no installable Lunar Modulator release for the FM-1 yet. Offline diagnostic firmware variants exist, but none has run on an FM-1. Be wary of any file that claims to be Lunar Modulator for the device: it is not from this project. To try Lunar Modulator, use the browser simulator.
Any additional device interaction must follow the staged plan in chapter 11. The project has not installed or run Lunar on an FM-1.
1.4 Safety and care
Lunar Modulator does not change how the FM-1 is built or powered. M-VAVE’s instructions for the battery, charging and care of the instrument still apply; follow M-VAVE’s manual for them.
Protect your hearing
Synthesizer engines can produce loud, sudden or piercing sounds, particularly when you turn a parameter quickly, raise a feedback or resonance control, or play many notes at once. Start with the volume low, on headphones and on speakers alike, and raise it while you play. In the simulator, MASTER sets the output level and the firmware’s limiter holds the output just below full scale, but your computer’s own volume still applies on top of both.
Do not open the case
Nothing in this manual asks you to open your FM-1. The recovery route described in chapter 11 connects to the USB socket from outside.
Your FM-1 is unchanged
Using the simulator or the desktop tools sends nothing to an FM-1, even one connected to the same computer. The simulator reads MIDI from a keyboard you connect; it sends no MIDI at all.
1.5 About this manual
- Controls are written as the panel prints them: SELECT, KNOB1, PLAY/STOP. Sequencer functions that are still to be given a key are drawn with a dashed outline, such as LOOP.
- Statuses. The status line under a heading says where the function described below it works today, using the three labels above.
- Notes add detail and tips suggest a way of working. Cautions protect your hearing and your data; warnings protect your instrument.
- Note names. Middle C, MIDI note 60, is C4. The FM-1’s lowest key, F3, is MIDI note 53.
- Generated reference. The parameter tables, value lists and sequencer tables are generated from the firmware’s code each time the manual is built, so they always match the build named below.
- Online and in print. The newest edition is on the project’s website, with a PDF of the whole manual beside it. Corrections are welcome as issues on the project’s repository.
| Generated on | 2026-11-15 |
|---|---|
| From commit | 1552b4a |
| Sound engines in the build | Macro, Shapes, Macro Heavy, Six-Op FM, FM6, Sophie, Drums, Acid Bass, Comet Kit, Crater Kit, Drawbar, Trio, Phase Bend, Test Sine |
| Effects in the build | Plate, Ensemble, Diffuse, PSX Verb, Crush, Fold, Drive, Echo, Warble, Filter, Comb, Comp, Limiter, DJ Filter, Tilt, Master Sat, Isolator, EQ, Room, Hall, Gate, Squash, Transient, Repeat, Test Gain, Test Ext |
| Sequencer in the build | yes |
| Browser simulator published with it | yes |
| Tools | Python-Markdown 3.11 |