Emu68 Hatcher

Build ready-to-run SD cards with pre-configured Workbench installation (+batteries included) for PiStorm-accelerated Amigas.

Runs on macOS, Linux and Windows.

Note

Still in an early stage - see known issues. Only actively tested on my A1200 + pistorm32-lite + CM4 / on macOS. If you run it on different hardware or OS, let me know on the Discord or open a GitHub issue - even just "it worked" is useful.

Features

• Bootable Emu68 install for pistorm32-lite, pistorm, pistorm16
• Workbench install from stock ADFs (3.1 / 3.2 / 3.2.2.1 / 3.2.3), or AmigaOS 3.9 from the original CD image
• Customizable package set: MUI, WHDLoad+WHDLoadWrapper, IBrowse, HippoPlayer, ...
• RTG (Picasso96), networking (Roadshow TCP/IP stack + wifipi/genet drivers), partition layout editor (PFS3 + FFS) - user-supplied full versions of Roadshow and Picasso96 supported
• SD card flashing (direct, or write the .img to a card after the build), sparse .img by default
• Build configs as JSON (save / load)

→ see docs for more

Quickstart

1. Download

From releases:

• macOS: emu68hatcher-VERSION-macos-arm64.dmg (or -macos-x64.dmg on Intel)
• Linux (Debian / Ubuntu): emu68hatcher-VERSION-linux-x64.deb (or -arm64.deb)
• Windows: emu68hatcher-VERSION-windows-x64.exe (or -arm64.exe)

2. Install

• macOS: drag Emu68 Hatcher.app into /Applications
• Linux: sudo apt install ./emu68hatcher-*-linux-*.deb
• Windows: run the .exe installer

3. Launch

• macOS: open Emu68 Hatcher from /Applications. First run: grant Full Disk Access to hst-imager so SD card writes work - see the installation guide.
• Linux: emu68hatcher
• Windows: from the Start menu

From source (any OS, Python 3.10+)

git clone https://github.com/rootrootde/emu68hatcher.git
cd emu68hatcher
python3 bootstrap.py            # windows: python bootstrap.py
emu68hatcher                    # windows: python -m emu68hatcher

For usage see → docs.

Credits

Thanks to:

• mja65's fantastic work on the Emu68 Imager project
• Emu68 and Emu68-tools by Michal Schulz (MPL-2.0) - m68k emulation and the on-Amiga companion tools (EmuControl, VideoCore.card, WiFiPi.device, ...)
• hst-imager and hst-amiga by Henrik Stengaard (MIT) - disk image + RDB tooling

Bundled / downloaded at build time:

• WHDLoad
• Roadshow Demo bundled with permission from A. Magerl (APC&TCP)
• 7-Zip (GNU LGPL) - downloaded at install time, License.txt copied alongside the binary
• Poseidon USB stack by Chris Hodges - downloaded from the iComp wiki at build time when USB support is selected
• Aminet packages (MUI, HippoPlayer, IBrowse, akDatatypes, Picasso96, ...) - downloaded from aminet.net at build time; each ships its own readme with license

License

LICENSE