Emu68 Hatcher

Build ready-to-run SD cards with pre-configured Workbench installation for PiStorm-accelerated Amigas.

Cross-platform Python+Qt app trying to be an Emu68 Imager alternative for Mac and Linux users

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)
• Customizable package set: MUI, WHDLoad+WHDLoadWrapper, IBrowse, HippoPlayer, ...
• RTG (Picasso96), network stack (Roadshow Demo), partition layout editor (PFS3 + FFS)
• Build configs as JSON (save / load)

→ see docs for more

Quickstart

1. Download

From releases:

• macOS: emu68hatcher-VERSION-macos-arm64.dmg
• 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. Gatekeeper may block on first launch - 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

This project would have never been possible without mja65's work on the fantastic Emu68 Imager project. The code in this repo borrows heavily from emu68 imager, and the overall design and workflow is similar.

Built on top of:

• Emu68 and Emu68-tools by Michal Schulz (MPL-2.0) - the m68k JIT 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 by Bert Jahn - donationware; please donate if you use it
• Roadshow Demo bundled with permission from A. Magerl (APC&TCP)
• 7-Zip (GNU LGPL) - downloaded at install time, License.txt copied alongside the binary
• Aminet packages (MUI, HippoPlayer, IBrowse, akDatatypes, Picasso96, ...) - downloaded from aminet.net at build time; each ships its own readme with license

License

LICENSE