sloop-fm1 README

The project's README from github.com/isod89/sloop-fm1. As one markdown file: README.md.

SLOOP

A live groovebox firmware for the M-VAVE FM-1 — for any style.
Free and open source (GPL-3.0), based on Felucca.


SLOOP turns the FM-1 into a four-track groovebox you play live: three synths and a drum machine with 16 sounds on the white keys, nine synthesis engines, your own samples, a song mode you play with your hands. House, techno, hip-hop, drum & bass, synthwave, lo-fi, ambient, chiptune — it does not pick a style for you. No factory patterns, nothing to load: everything you hear, you play.

Screenshots

SLOOP screens on the FM-1

The FM-1's screen: start-up, the four tracks (recording), the drum grid and the acoustic kit, the sounds by kind, the layers (punch-in FX, steps, key and chords, mix, erase), a free take, the FX sends.

SLOOP web editor: the drum track

The web editor: the drum track as a 16-lane grid, with levels and ratchets.

New in 2.2

Everything in SLOOP.md.

Features

Install

From the browser: open the SLOOP installer in Chrome or Edge, connect the FM-1 by USB (a data cable, no hub), press INSTALL and wait for Done. Nothing to download or compile. The web editor works the same way.

Other ways: the .fwsc of each release with python tools/fm1_install.py sloop-2.2.fwsc (needs pip install mido python-rtmidi), or build it yourself and run INSTALL-SLOOP.bat (Windows).

Going back: M-VAVE's own updater (M-UPGRADE) and the official FM-1 firmware. If an install is cut off, the FM-1 stays in update mode: press Install again and it finishes.

Custom firmware is installed at your own risk. If an FM-1 no longer starts, recovery needs FM-1-transporter.

Documentation

Building

See BUILDING.md. In short: the JieLi toolchain and three files of the AC79 SDK, then ./build.sh (Linux / macOS) or INSTALL-SLOOP.bat (Windows with WSL). tests/run_tests.sh runs the host test suite (audio renders, sequencer timing, UI, storage, update loader, web pages).

Credits

SLOOP is a fork of Felucca by Leo Kuroshita (@kurogedelic), Hügelton Instruments: the engines, the sequencer, the editor and the installer come from there. Font: Terminus (SIL OFL 1.1). Samples: Versilian Studios VSCO-2 CE and VCSL, Sonic Pi (all CC0). PHASE engine after CrispyZebra; VOICE after klattsch. Icons: Fukiai.

Licence

Code: GPL-3.0-only (see LICENSE and LICENSING.md for the assets). No warranty. M-VAVE and FM-1 are trademarks of their owners; SLOOP is not affiliated with M-VAVE. Drum kit names describe styles, not products.

sloop-fm1 (isod89/sloop-fm1)

Searching Database…

What is this?SLOOP is a free, open-source custom firmware for the M-VAVE FM-1 hardware groovebox, replacing the stock firmware with a deeper synth engine set, a real drum machine, live sequencing, and an in-browser editor.
Is this an app I install on my computer, or firmware for the device itself?It's firmware that gets flashed directly onto the FM-1 hardware; it comes paired with a browser-based web editor for things like chopping samples and tweaking parameters, synced live with the device over USB.
How do I install SLOOP on my FM-1?Open the SLOOP installer in Chrome or Edge, connect the FM-1 by USB with a plain data cable (no hub), click INSTALL, and wait for it to finish — nothing to download or compile.
Do I need Python or a build toolchain to flash it?No, the browser installer handles everything. If you prefer the manual route, you can flash the .fwsc release file with a Python script that needs mido and python-rtmidi, or build from source yourself with INSTALL-SLOOP.bat on Windows.
What happens if the install goes wrong or I want to go back to stock firmware?An interrupted install leaves the FM-1 in update mode so you can just press Install again, but flashing custom firmware is at your own risk; if the device stops starting, recovery requires the separate FM-1-transporter tool. You can also return to M-VAVE's official M-UPGRADE firmware at any time.
Does this work on any groovebox, or only the FM-1?SLOOP only runs on M-VAVE FM-1 hardware; it's a fork of Felucca, a firmware originally built for Hügelton Instruments' hardware by Leo Kuroshita.
What sound engines does SLOOP give me?Nine synth engines (analog, 4-op FM, phase distortion, three-oscillator, tonewheel organ, formant voice, granular, lo-fi chip, sampler) plus 37 drum kits covering genres from 808/909 to phonk, amapiano, UK garage and jazz brushes, all with envelopes, LFO, arpeggiator and effect sends.
What's new in version 2.2?A rebuilt drum engine modeled on classic drum machines, 32 rebuilt synthesized kits plus a sampled acoustic kit, new sounds like 808 SLIDE and ACID 303, a stereo chorus and new feedback-delay reverb, and the ability to lock a layer open with one button press.
Can I record my own samples into it?Yes, there are three user sample slots, and the web editor lets you record audio, chop it into 16 pieces by tapping along, then upload the chops straight to the device.
Why is it called a fork of Felucca?SLOOP reuses the engines, sequencer, editor and installer from Felucca, a firmware by Leo Kuroshita (@kurogedelic) for Hügelton Instruments, adapted and extended for the M-VAVE FM-1.
Creator
isod89
Size
12.5 MB
Stars
524
Age
13d
Commits · 90 Days