Amiberry

Turn your computer into an Amiga!

Amiberry is an optimized Amiga emulator, originally designed for ARM-based devices (such as the Raspberry Pi) but grown tremendously over time. It now runs on macOS (both Intel and Apple Silicon), Linux (x86-64, arm64 and RISC-V), Windows x86-64, FreeBSD, Android, and the list keeps expanding.

Be it a classic A500, A1200, CD32 or up to a high-end model equipped with a 68060 and a graphics card, we’ve got you covered. The code is based on the latest WinUAE for the core emulation with some changes where necessary. Additionally, there are several features that were developed specifically for Amiberry, such as WHDLoad support, custom events, support for RetroArch mapping, host-tools integration, drag-and-drop file handling, and more.

The main Amiberry GUI

It’s an open-source project under GPLv3 that started back in 2016, built with the efforts of several people and based on previous work of others. You are welcome to join the project and help make Amiberry even better!

Supported Platforms

Amiberry is designed for ARM (32/64-bit), x86_64, and RISC-V platforms. It natively runs on:

  • Linux (Raspberry Pi OS, Debian, Ubuntu, Fedora, Arch, Manjaro, and more)
  • macOS (both Intel x86 and Apple Silicon M1/M2/M3/M4)
  • Windows (x86_64, via MinGW-w64/GCC)
  • FreeBSD (build-from-source; no pre-built binaries)
  • Flatpak
  • Android (coming soon to the Play Store)
  • Libretro
  • iOS (coming soon to the Apple Store)

Amiberry is already included in several popular distros such as RetroPie, DietPi, Batocera, Pimiga, and others — in many cases it can be installed or upgraded directly from within their ecosystems.

Amiberry is currently available in two separate versions: Amiberry and Amiberry-Lite. See here to decide which version is the best for your needs!

Installation

Starting with version 7, Amiberry is delivered as a system package rather than just a zip archive. This means dependencies are handled automatically — no need to manually install SDL2 and other libraries first.

  • Debian / Ubuntu / Raspberry Pi OS: .deb package — install with sudo apt install ./amiberry-XYZ.deb
  • Fedora / RHEL: .rpm package
  • macOS: .dmg disk image — drag Amiberry.app to your Applications folder
    (macOS binaries are now signed with an Apple developer certificate and notarized — no need to manually bypass Gatekeeper)
  • Windows: .zip archive — extract and run Amiberry.exe

For other platforms or distros, you can compile from source — see the [README on GitHub] for instructions.

Directory Structure

Amiberry now uses standard system paths. Shared libraries are placed where the OS expects them, while user-configurable content (configurations, floppy images, hard drives, ROMs, etc.) lives in an Amiberry folder inside your HOME directory. Internal data directories are placed separately to reduce clutter. Check the [Wiki] for full details.

Key Features

  • High Performance JIT: Custom Just-In-Time compiler for extreme speed on supported devices
  • WHDLoad Booter: Native support for launching WHDLoad titles directly — no manual setup needed
  • RetroArch Integration: Seamless controller mapping for RetroArch setups
  • Host Tools Integration: Launch host applications directly from the emulation
  • Dynamic File Handling: Drag-and-drop support for floppies, hardfiles, and config files
  • Network Emulation: uaenet.device implemented using pcap for improved Amiga internet connectivity
  • Broad Disk Image Support: ADF, DMS, IPF (floppies); CUE/BIN, ISO, CHD (including CHD+zstd) for CD images; HDF for hard drives; LHA for WHDLoad titles (CHD+zstd added in v7.1.0)
  • Native GUI: Responsive, feature-rich interface designed for both mouse and controller navigation

Donations

If you like this project, you can help further development by donating any amount you can. There are multiple options for donations, so you can pick the one you prefer:

Donations go towards getting new devices to port Amiberry to, covering some of the costs, keeping the motivation for the countless hours of work involved in the project, etc.

What You Need

  • A supported device: Raspberry Pi or other ARM SBC, a Linux x86-64 machine, a macOS computer (Intel or Apple Silicon), or a Windows x86-64 PC
  • Amiga Kickstart ROMs: Amiberry ships with the open-source AROS ROM as a fallback, but for best compatibility you’ll need real Kickstart ROMs. These are not freely distributable — you can purchase them from Cloanto’s Amiga Forever package, or use the ROMs included in official AmigaOS 3.x releases from Hyperion
  • Amiga software: ADF, DMS, IPF (floppy images), CUE/BIN, ISO, CHD (CD images, e.g. for CD32), HDF (hard drive images), or LHA archives for WHDLoad titles