keremimo / melodee

# Melodee
**TL;DR:** connect your FM-1 to a computer by USB, open the
web installer in Chrome or Edge, and press Install.
Current builds use both CPU cores. Following the CPU voltage startup fix,
single-core packages are retired from the build, release and installer workflows.
Melodee 1.3.5 and later builds with boot protection return to USB update mode after an interrupted
firmware write, including power loss. Switch on again, or hold **OCT− alone** while
switching on; three short key-light flashes mean you can reconnect USB and press Install
again. The first installation of this protection still needs uninterrupted power while
its boot sector is written. Older releases do not have it. See
boot protection and validation limits.
No extra hardware is needed. Use at your own risk. **Switching to another custom firmware?**
Use **Back up and install TransitFM1** in the web installer first, then install your
destination firmware with its own installer once the FM-1 shows **TRANSIT**. Use
TransitFM1 as the stop between firmwares
instead of returning to V15: it guards the next write against interruptions, except
possibly the last sector. Use TransitFM1 **0.1.3**; 0.1 has startup and MIDI stalls,
and 0.1.2 was withdrawn. **For Baud Girl, install official V15 first, then use
Baud Girl's installer:** its image can exceed TransitFM1's write range. Keep power
and USB connected throughout, and close other apps sending MIDI.
**Return to official V15** is still available if you want the official firmware itself.
Both options save a complete backup first. If your firmware cannot export one, you can select
**Skip backup** and confirm that Melodee music, sounds and settings may be lost.
For a black-screen device already in ROM UBOOT, use the
direct USB recovery tool.
Multi-engine synthesizer and sequencer firmware for the M-VAVE FM-1. Current release:
**Melodee 1.4.5**
(release notes, what's new).
The stock-restore installer accepts 1.4's backup capabilities. Existing Melodee 1.4.0
users can return to official V15 directly from the updated web installer.
The stable installer includes the latest UI, recording, effects, SID and preset-bank
changes. Read the illustrated manual
for this release, or the nightly guide
for development firmware.
Melodee is a modified version of Felucca by Leo Kuroshita
(@kurogedelic), Hügelton Instruments, and
follows Felucca 1.0's design. Melodee is not affiliated with or endorsed by Hügelton Instruments;
please report Melodee problems here, not to Felucca. The installer also finds an FM-1 that still
runs Felucca.
- Install: web installer (Chrome or Edge, USB), or `tools/fm1_install.py` from a terminal
- Editor: web editor
- Build: BUILDING.md
Tagged releases from 1.4.4 use the FM-1 shared build workflow
to build and attest firmware from the tagged source. See release verification
for the process and the command to check a downloaded package. An attestation establishes
build provenance; hardware validation is a separate check.
## What's