Repository navigation
ffemu v1.2
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-07, commit 822b6e3. 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 OLED display, reads an emulated USB drive, and takes the keyboard for its buttons and rotary encoder.
NOTE: The previous release 1.1 was withdrawn; 1.2 has everything 1.1 had.
What's new since 1.0
At a glance: version 1.2 adds the build based on the Apple2 firmware, more deeply emulates the floppy drive interface to the computer, uses the physical USB drive attached when run without arguments, and improves the terminal UI.
- Introduced two flavors:
ffemuruns the Shugart firmware, as before, andffemu-apple2the Apple2 firmware, which lists.hfeimages only. Each keeps its own settings, flash memory state and log file, so both can run at once. - Now ffemu takes the physical USB drive attached, if there is one; if there are more, it lists them, each with the
/dev/disk device path to specify as the argument. - The keyboard controls the emulated host computer's signals on the floppy interface, shown in the Controls pane: Drive Select, Motor On, Direction of steps, Step pulse, and Side for Shugart (FDD types called
Step/Dir: actual Shugart (Beta Disk / TR-DOS), IBM PC, Amiga), Drive Enable and the four stepper Phases for Apple2/Agat, which go through the states a computer goes through, one per key press. The firmware's own floppy code runs on them, so the track display, the head steps and the beeper behave as on the device; the Status window shows the cylinder, the side and the image mounted. - Fixed minor issues:
- **
FF.CFGnow stays visible** though dimmed while the USB drive is ejected, and is re-read on every Eject. - The color scheme for the keyboard keys and Gotek buttons is improved.
- Ctrl+L now repaints the screen, for a terminal that got out of sync, which happens with TUI apps, especially on Windows after resizing.
- The display could hang with a 100% CPU core usage.
- The display auto-scrolled slowly on a virtual machine whose coarse sleeps were missed at the start.
- **
Commits since 1.0
- gotek/floppy: Provide C fallbacks for ARM-only code
- ffemu: Fix up mark, explain Flash mem dialog, mark cut bottom line, add Ctrl+L
- ffemu: Move version to version.h, bumped to 1.0+
- ffemu: Use term "USB drive" everywhere instead of "USB flash drive"
- ffemu: Fix slow display on OS whose coarse sleeps were missed at start
- ffemu: Fix hang of firmware in handler waiting on I2C bus
- ffemu: Add build for Apple2 firmware
- ffemu: Emulate host computer's signals on floppy interface
- ffemu: Keep showing FF.CFG, dimmed, while USB drive is out
- ffemu: Redesign keys and buttons: red keys, round buttons, lit when pressed
- ffemu: Take USB drive attached when run without argument
Downloads
- Linux (x86-64, Ubuntu 22.04+):
ffemu-1.2-linux-x86_64.tar.gz,ffemu-apple2-1.2-linux-x86_64.tar.gz - Windows (Git Bash, MSYS2 or Cygwin):
ffemu-1.2-windows.exe,ffemu-apple2-1.2-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.
