Skip to content

ffemu v1.4

Choose a tag to compare

@mike-shevchenko mike-shevchenko released this 16 Oct 19:44
· 272 commits to master since this release

ffemu on Ubuntu

Introducing ffemu, a build of FlashFloppy's user interface for a PC

The Gotek firmware inside this release is the stock FlashFloppy, upstream master as of 2026-10-13, commit d4da404. Every firmware image built from this release is byte-identical to the upstream's.

ffemu runs the FlashFloppy user interface in a terminal, with no Gotek hardware. The firmware's own code is compiled natively: it draws on an emulated display, reads an emulated USB drive, and takes the keyboard for its buttons, its rotary encoder and the host computer's signals on the floppy interface.

What's new since 1.3

At a glance: version 1.4 draws the character LCD as a real one looks, marks the factory defaults in the configuration dialog, keeps the Console through the firmware's own resets, and offers the firmware's 8x16 font made from 6x13.

  • Faint dots on the character LCD: in the half block rendering, on a terminal of 16 colors or more, the dots of each character that are not lit show faintly, as on a real panel; the characters are white on a blue panel, bright or dark.
  • Factory defaults are marked with = in the Flash mem dialog (key 9).
  • The Console (named Firmware console until now, though it shows ffemu's own lines too) keeps its contents when the firmware resets itself, after a factory reset for one, with a separator line where the reset was; only a power cycle starts it afresh.
  • One question for all of FF.CFG: when OK writes options that FF.CFG on the drive sets otherwise, ffemu asks once and changes every one of them, in a single pass with one .BAK; until now it listed at most four and changed only those.
  • 8x16 font made from 6x13: a check box in the Display dialog (key 0) draws the OLED's 8x16 font as the firmware's logfile and debug builds for the STM32F105/AT32F415 do since keirf#1078, bold from the 6x13 one, to save flash.
  • The emulated firmware's configuration log lines match the shorter ones of the firmware since keirf#1078.
  • Built with the firmware: the plain make at the top of the tree builds both ffemu programs as well, and so does the CI build.
  • Fixed minor issues:
    • Dialog colors: the note of a Save is dark green, readable on the light gray; a button's text is bright white while it has the focus; hotkeys are dark red; Tab reaches the FF.CFG buttons before OK and Cancel.
    • The hotkey letters of the Flash mem dialog are red only while a letter moves the focus: not while typing in a text field, nor under a message box.
    • A long path in the note of a Save is shortened at its left with ... to fit the dialog.

Commits since 1.3

  • ffemu: Bump version to 1.3+
  • ffemu: Fix dialog colors and Flash mem dialog's Tab order
  • ffemu: Mark factory defaults in Flash mem dialog with =
  • ffemu: Rename Firmware console pane to Console
  • ffemu: Keep Console through firmware's own resets, marked by separator
  • ffemu: Ask about every option FF.CFG would override, without listing them
  • ffemu: Shorten config log lines as firmware does
  • ffemu: Add check box for 8x16 font made from 6x13 one to Display type dialog
  • ffemu: Highlight Flash mem dialog's hotkeys only while letters move focus
  • ffemu: Shorten path in Flash mem dialog's note at its left to fit
  • ffemu: Note in README that it was written with help of Claude
  • ffemu: Show LCD's unlit dots faintly in half blocks, white ink on any blue
  • ffemu: Keep README and scripts within 80 columns
  • ffemu: Build both programs with firmware by plain make, and so in CI
  • ffemu: Bump version to 1.4

Downloads

  • Linux (x86-64, Ubuntu 22.04+): ffemu-1.4-linux-x86_64.tar.gz, ffemu-apple2-1.4-linux-x86_64.tar.gz
  • Windows (Git Bash, MSYS2 or Cygwin): ffemu-1.4-windows.exe, ffemu-apple2-1.4-windows.exe

Running

ffemu [ <directory> | <usb-drive-image> | /dev/sd<usb-drive-dev>1 ]
ffemu-apple2 [ <directory> | <usb-drive-image> | /dev/sd<usb-drive-dev>1 ]

Without an argument, the physical USB drive attached is taken. See ffemu/README.md for the details.