Skip to content

Releases

Amenity 2.1.1

Choose a tag to compare

@github-actions github-actions released this 15 Nov 12:06

Amenity 2.1.1

Amenity 2.1.1 follows a MIDI clock over Bluetooth more reliably: it no longer
stops when the clock drops out for a moment, and it picks the clock up again in
time.

Install or update: https://ejtb76.github.io/amenity/ (Chrome or Edge, FM-1 on USB). Your own breaks and your settings stay.

Fixed

  • Following a clock over Bluetooth no longer drops out. Each Bluetooth
    MIDI message carries the time it was sent, and one message with a wrong time
    (seen: 1.5 seconds off) could make Amenity think the clock had stopped, so
    the break went silent while the other side played on. Amenity now spots a
    wrong time and uses the moment the message arrived instead.
  • A Stop from the device that leads always stops Amenity, also when its
    clock went quiet just before.
  • After a short gap in the clock, the break is back in time at once.
    Before, when a few pulses went missing (under half a second), the break
    waited about as long as the gap and then ran behind the sender.

Changed

  • When the clock stops without a Stop, the break plays on. A Bluetooth
    dropout or a computer that hangs no longer stops it: after half a second
    EXT turns orange, the screen says NO CLOCK: ON and the break carries
    on at the tempo it measured. When the clock comes back, Amenity picks it up
    where the sender is now, without a new Start. A Stop from the sender, a new
    Start or PLAY stops it. (In 2.1 the break stopped after half a second
    without clock and stayed silent until the next Start.)
    While Amenity plays on alone it sends no clock to the devices behind it
    (MIDI THRU): they wait for the clock to come back.

Updating from 2.1

  • Install over 2.1 (or 2.0) from the page above; your own breaks, their
    order and your settings stay
    .
  • Going back to stock (or another firmware) still erases your own breaks:
    keep your WAV files. Your settings stay and come back when you install
    Amenity again.
  • Amenity 2.1.1's identity is FM-1_817020101 (pattern FM-1_817XXYYZZ).

Works on both FM-1 flash chips (Puya P25Q80 and UC25HQ80), as before.

Third-party audio

The built-in breaks are third-party recordings and are not covered by
Amenity's licence; all rights belong to their owners:
"Amen, Brother", The Winstons (1969); "Apache", Incredible Bongo Band (1973);
"Think (About It)", Lyn Collins (1972). See assets/third-party/.

Files

  • AMENITY-V21.fwsc: the firmware, for The Firmware Hub and other installers
    (the same file as amenity-2.1.1.fwsc).
  • firmware.json: the firmware described for hubs.

Amenity 2.1.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 21:00

Amenity 2.1

Amenity 2.1 remembers your settings, plays in time with a second FM-1 over
Bluetooth, passes MIDI on like a classic MIDI THRU, and gets half time /
double time, a quieter screen if you want one, and its own boot screen.

Install or update: https://ejtb76.github.io/amenity/ (Chrome or Edge, FM-1 on USB). Your own breaks stay.

New

  • Your settings are kept over a power-off: the break, the tempo, every
    knob (EQ and FX pages too), the transpose, the feedback root, SEQ and the
    flashes setting. They are saved when you stop the sequencer, or two seconds
    after a change while it stands still, never while it plays. PLAY, REC and
    half / double time start fresh.
  • The connections page: tap EDIT (hold it, as before, for the CPU
    load). SELECT moves the cursor, SAVE does what the bottom line says:
    • BT: the Bluetooth MIDI devices around. SAVE=CONNECT connects to one
      (another FM-1, a keyboard), SAVE=LET GO lets it go. When the other side
      connected to Amenity, the row says CONNECTED.
    • USB: DEVICE (plugged into a computer, as always) or HOST: Amenity
      runs a USB-MIDI device plugged into it (HOST TO its name), with no
      computer. The FM-1 gives no power to it: use a powered USB hub. After a
      power-on it is a DEVICE again. (Not yet tested on a real FM-1: tell us how
      it goes.)
    • UI: FLASHES ON / OFF (see below).
  • Two FM-1s in time over Bluetooth. Connect from either one; one
    connection carries clock, Start and Stop both ways, so whichever you press
    PLAY on leads. Works with any fm1-base firmware on the other FM-1.
  • MIDI THRU (daisy chain). Everything that comes in (notes, CC, clock,
    Start and Stop; not SysEx) goes straight on to the other outs, never back
    where it came from: the TRS jack to USB and Bluetooth, USB to Bluetooth,
    Bluetooth to USB. So your DAW, or a drum machine on the TRS jack, can lead
    Amenity and a second FM-1 over Bluetooth. While Amenity plays on its own
    clock, incoming clock is not passed on (no double clock downstream).
    (Tested from USB to Bluetooth; from the TRS jack not yet on a real FM-1.)
  • Half time / double time on OCT− / OCT+. The break runs at half or twice
    the tempo from the next bar, its first step on a 1 (1/2X or 2X beside the
    tempo, amber until it comes in). The tempo, the MIDI clock out and an
    external clock stay as they are, so it works while following a clock too.
    SEL + OCT− / OCT+ still nudge the tempo by 0.1 BPM.
  • Flashes off: some players find the screen's glow, pops, shakes and
    ripples too much. UI on the connections page turns them off: the grid
    stays still and what happens is only written. On by default.
  • HOME also turns the filter off, beside variation and warp.
  • A boot screen of its own: the Amenity logo with the version under it.

Better

  • MIDI clock: Amenity times the sender's clock before Start (most DAWs run
    it while stopped), so it starts at the right tempo at once, and settles on
    it sooner.
  • The hints on the screen read SAVE=CONNECT, SELECT=MOVE, EDIT=BACK and so on.

Crashes

Some players saw Amenity restart after a crash while it took MIDI (a clock,
Bluetooth). 2.1 keeps a record of every crash, across power-offs, so it can
be found: if it happens to you, see "When it crashes" in the README and send
what fm1_remote.py log prints. After such a restart Bluetooth may not
connect again until the FM-1 is switched off and on.

Updating from 2.0

  • Install over 2.0 from the page above; your own breaks and their order
    stay
    . The first time, the settings start as before (160 BPM, the Amen);
    from then on they are kept.
  • OCT− / OCT+ changed: in 2.0 they halved or doubled the tempo; now they
    switch to half time / double time and leave the tempo alone.
  • EDIT changed: a tap opens the connections page; hold it for the CPU load.
  • Going back to stock (or another firmware) still erases your own breaks:
    keep your WAV files. Your settings stay and come back when you install
    Amenity again (a break that is gone falls back to the Amen).
  • Amenity 2.1's identity is FM-1_817020100 (pattern FM-1_817XXYYZZ).

Works on both FM-1 flash chips (Puya P25Q80 and UC25HQ80), as 2.0.

Third-party audio

The built-in breaks are third-party recordings and are not covered by
Amenity's licence; all rights belong to their owners:
"Amen, Brother", The Winstons (1969); "Apache", Incredible Bongo Band (1973);
"Think (About It)", Lyn Collins (1972). See assets/third-party/.

Files

  • AMENITY-V21.fwsc: the firmware, for The Firmware Hub and other installers
    (the same file as amenity-2.1.0.fwsc).
  • firmware.json: the firmware described for hubs.

Amenity 2.0.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 19:09

Amenity 2 is rebuilt on fm1-base
and felucca-bsp instead of M-VAVE's FM1 Open SDK. Same break engine, more
breaks, your own breaks, a steadier MIDI clock and a livelier screen.

Install: https://ejtb76.github.io/amenity/ (Chrome or Edge, FM-1 on USB).
Your breaks: https://ejtb76.github.io/amenity/breaks/

New

  • Three built-in breaks: Amen, Apache and Think. PRESETS picks the break;
    the new one takes over from the next hit.

  • Your own breaks: four slots, filled from a web page. Drop a WAV of one,
    two, four or eight bars (of four or eight, the first two are used); the page
    guesses how many, makes it as loud as the built-in breaks and picks its hits
    for the black keys. Drag to reorder, delete from the page.

  • Instant effects on the top three black keys while held: feedback, lo-fi,
    an octave down. SEQ's fills use them too, and one fill in four sweeps the
    filter.

  • The flip: with VARIATION up, the break sometimes restarts on the "and"
    of beat 3.

  • Tempo on SELECT (1 BPM a detent, SEL held for 0.1). OCT− / OCT+ halve
    or double it on the next beat, and only within 40–320 BPM.

  • MIDI clock follows with a delay-locked loop, from USB, Bluetooth or
    TRS, and only from the device that sent Start.

  • The screen: hits flash, fills and rolls glow and shake, flips ripple,
    stretch and octave-down steps move; the keys light with the slice that
    sounds. VARIATION and WARP show NEXT until the next pattern takes them.

  • FEEDBACK goes to 100%. LO-FI moved to K3 on the FX page; EDIT held shows
    the CPU load.

  • Installing uses fm1-base's installer: an install that stops carries on
    when you press Install again, and "Back to the stock firmware" puts M-VAVE's
    V15 or V16 back.

  • Works on both FM-1 flash chips: the original Puya P25Q80 and the
    UC25HQ80 of the newer units (sold since autumn 2026, mostly on AliExpress).
    Amenity saves your breaks, and installs and updates, on both.

Coming from Amenity 1.0

  • Nothing of 1.0 carries over. Amenity 2 keeps no settings from 1.0, and
    does not use 1.0's sample bank: the breaks are built into the firmware now.
  • The installer may ask you to go back to the stock firmware first, then
    install Amenity 2.
  • Settings are not saved between power-ons: Amenity starts at 160 BPM on the
    Amen. Your own breaks and their order are kept.
  • Installing any other firmware, or going back to stock, erases your own
    breaks.
    Keep your WAV files.
  • Amenity 2's identity is FM-1_817020000 (pattern FM-1_817XXYYZZ); 1.0's
    was FM-1_8170001.

Third-party audio

The built-in breaks are third-party recordings and are not covered by
Amenity's licence; all rights belong to their owners:
"Amen, Brother", The Winstons (1969); "Apache", Incredible Bongo Band (1973);
"Think (About It)", Lyn Collins (1972). See assets/third-party/.

Files

  • AMENITY-V20.fwsc: the firmware, for The Firmware Hub and other installers
    (the same file as amenity-2.0.fwsc).
  • firmware.json: the firmware described for hubs.

Amenity 1.0.0

Choose a tag to compare

@ejtb76 ejtb76 released this 01 Nov 10:13

Amenity 1.0.0: a live jungle firmware for the M-VAVE FM-1, by Presethead.

Amenity plays the Amen break, sliced into sixteen 8ths, and lets you tear it up live from the panel: rolls, builds, echo and old-sampler STRETCH on the white keys, single hits on the black keys, a pattern that varies itself with a fill at the end of every phrase, ringing feedback, warp, a DJ filter, lo-fi, EQ, saturation and compression. It follows MIDI clock from your DAW or drum machine and sends its own clock when it leads.

Identity: FM-1_8170001

Installing

  • AMENITY-V10-installer.html: open it in Chrome or Edge, connect the FM-1 over USB and follow the steps. It installs the firmware and, if the FM-1 has no sample bank yet, writes the Amen break to it.
  • AMENITY-V10.fwsc: the firmware file, for The Firmware Hub or M-VAVE's tools.

M-VAVE's update loader is included, so you can always go back to V15 or move to another firmware. The firmware also carries its own 20 kHz copy of the break (the screen shows 20K) for when the sample bank holds no AMEN slot.

Third-party audio

The Amen break is from The Winstons, "Amen, Brother" (1969), drums by Gregory C. Coleman. The recording is not covered by this project's licence and is not ours: see assets/third-party/amen/README.md. The firmware builds without it (see the README).

Credits

FM-1 hardware and the FM1 Open SDK: M-VAVE. SEA codec: Dani Biró. VESPER by Fat Cat Studios showed how to add a sound engine to FM1 Open. Ported from Presethead's Jungle Choppa VST plugin.

Licence: GPL-3.0 with the FM1 SDK linking exception (the Amen recording excluded).