Skip to content

Install

Requirements

  • macOS 12+ (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 (recent Ubuntu/Debian, Fedora, Arch, …) - .deb installer for Debian/Ubuntu (x64 / arm64), manual Python install everywhere else
  • a 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):
Workbench Kickstart (A1200)
3.1 40.068 (or Cloanto 45.064 / 45.066 from Amiga Forever)
3.2 47.96
3.2.2.1 47.111
3.2.3 47.115

Pick your OS

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 hst-imager

macOS protects raw disk access, even on removable media like SD cards, so an app needs explicit permission from you to write to one. Emu68 Hatcher uses hst-imager to write the card, so it's hst-imager that needs Full Disk Access - not the app itself.

Open the app, click Download Missing Tools on the Start tab. After hst-imager downloads, a dialog asks to register it with macOS - click Set Up Now, enter password, then enable hst-imager in the settings pane that opens.

Install from source

Needs Python 3.10+. Get the source tarball from the releases page (or git clone the repository) then run bootstrap.py:

# from a release tarball
tar xf emu68hatcher-<version>.tar.gz && cd emu68hatcher-<version>

# or from git
git clone https://github.com/rootrootde/emu68hatcher.git && cd emu68hatcher

python3 bootstrap.py
emu68hatcher

Native installer (Debian / Ubuntu)

Download the latest .deb for your machine (x64 or arm64) from the releases page and install:

sudo apt install ./emu68hatcher-*-linux-*.deb

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:

# from a release tarball
tar xf emu68hatcher-<version>.tar.gz && cd emu68hatcher-<version>

# or from git
git clone https://github.com/rootrootde/emu68hatcher.git && cd emu68hatcher

python3 bootstrap.py
emu68hatcher

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:

# from a release tarball (Windows 10+ has tar built in)
tar xf emu68hatcher-<version>.tar.gz; cd emu68hatcher-<version>

# or from git
git clone https://github.com/rootrootde/emu68hatcher.git; cd emu68hatcher

python bootstrap.py
emu68hatcher