Install¶
Requirements¶
- macOS 13+ (Apple Silicon or Intel) - the .app bundle includes Python, no separate install needed
- Windows 10/11 (x64 or arm64) - the .exe installer includes Python, no separate install needed
- Linux - .deb installer (x64 / arm64) for Ubuntu 22.04, Debian 12 or newer; on Fedora, Arch and other distros install from source with Python 3.10+
- an SD card, 4 GB minimum, 32+ GB recommended
- a Kickstart ROM + Workbench ADF floppy images (3.1 / 3.2 / 3.2.2.1 / 3.2.3 - pick one), or the AmigaOS 3.9 CD image (.iso) with a Kickstart 3.1 ROM:
| Workbench | ROM used by automatic selection |
|---|---|
| 3.1 | A1200 40.068 (or Cloanto 45.064 / 45.066 from Amiga Forever) |
| 3.2 | A1200 47.96 |
| 3.2.2.1 | A1200 47.111 |
| 3.2.3 | A1200 47.115 |
| 3.9 (CD .iso) | A1200 40.068 (the BoingBag soft ROM update loads at boot) |
Why is an A1200 ROM selected?
Automatic selection follows Emu68 Imager and prefers an A1200 ROM when available. It also works on an A600 with PiStorm/Emu68.
Pick your OS¶
Native installer (recommended)¶
Download the latest .dmg for your Mac (arm64 for Apple Silicon, x64 for Intel) from the releases page, open it and drag Emu68 Hatcher.app into /Applications.
First run: grant Full Disk Access to Emu68 Hatcher
macOS protects SD cards and external drives, so a build needs your permission to write the card and to read files such as an AGS image from another drive. macOS checks the app that starts the build, so Emu68 Hatcher needs Full Disk Access. hst-imager does not need its own entry.
Open the app, click Download Missing Tools… under Overview → Updates and tools. After hst-imager downloads, a dialog offers to open the settings if the app has no Full Disk Access yet - click Open Settings, enable Emu68 Hatcher (add it with + if it is not listed), then quit and reopen the app.
Each build that writes a card still asks for your password once. macOS shows that prompt with a warning that it could not verify the script; that is expected.
Install from source¶
Needs Python 3.10+. Get the source tarball from the releases page (or git clone the repository) then run bootstrap.py:
Native installer (Debian / Ubuntu)¶
Download the latest .deb for your machine (x64 or arm64) from the releases page and install:
Then run emu68hatcher to launch the GUI.
other Linux distros
No RPM or AUR packages available yet. On Fedora / openSUSE / Arch, use the manual install below.
Install from source¶
Needs Python 3.10+. Grab the source tarball from the releases page (or git clone the repo if you'd rather), then run bootstrap.py:
Native installer (recommended)¶
Download the latest .exe for your machine (x64 or arm64) from the releases page and run it. The installer puts the app + bundled Python in C:\Program Files\Emu68 Hatcher\ and adds a Start menu entry.
SmartScreen
On first run Windows SmartScreen may show a "Windows protected your PC" dialog. Click More info → Run anyway.
Install from source¶
Needs Python 3.10+ from python.org (tick Add Python to PATH during install). Grab the source tarball from the releases page (or git clone the repo if you'd rather), then run bootstrap.py: