Amiberry is an optimized Amiga emulator for Intel/AMD, ARM (32bit and 64bit) and RISC-V platforms. It runs on both Linux and macOS. Windows users should use WinUAE, even if Amiberry can run on WSL (Windows Subsystem for Linux).

The core emulation comes from WinUAE, and even the main GUI is designed to look similar to that. It includes JIT support, to get high-performance results on CPU-intensive emulated environments, like desktop applications. On top of that, there are some unique features developed specifically for Amiberry, such as the WHDLoad booter, support for RetroArch controller mapping, and several more.

There are currently two Amiberry editions available: Amiberry and Amiberry-Lite - see here to see which is the best pick for your needs.

Getting Amiberry

DEB packages

Amiberry is available as a DEB package for ARM32, ARM64(aarch64) and x86_64 Debian-based Linux platforms. You can download the latest version from the Releases area. Then, assuming you have it in your current directory, you can install it with:

  sudo apt update && sudo apt install ./amiberry_7.0.0_arm64.deb

If you on Arch Linux you'll find Amiberry on the AUR or if you use an AUR helper like yay, you can build and run:

  yay -S amiberry

macOS

Amiberry is available as a DMG package for macOS. You can download the latest version from the Releases area. After installing it in your Applications folder, you'll need to open a console and run xattr -rd com.apple.quarantine Amiberry.app, to whitelist it and allow it to run.

Distro package management

Some distros (like RetroPie, DietPi, Pimiga and others) already include Amiberry either pre-installed, or through their package management systems. Please follow the methods provided in those distros for a smoother experience, and refer to their owners for support during this process.

Flatpak

A flatpak version is available on Flathub

Compile from source

Alternatively, you can compile the latest version of Amiberry from source. To do that, follow these steps:

Linux

You'll need the -dev version of the required packages. For example, on Debian-based distros:

  sudo apt install cmake libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev libserialport-dev libportmidi-dev

Or if you're using an Arch-based distro (e.g. Manjaro), the relevant packages are:

  sudo pacman -S base-devel cmake sdl2 sdl2_ttf sdl2_image flac mpg123 libmpeg2 libserialport portmidi

macOS

Under macOS, you will need to install the required libraries using Homebrew:

    brew install cmake sdl2 mpg123 sdl2_ttf sdl2_image flac libmpeg2 libserialport portmidi dylibbundler wget

Clone this repository locally

  git clone https://github.com/BlitterStudio/amiberry
  cd amiberry

Build Amiberry

Amiberry requires CMake to build. The following commands will create a build directory, configure the build, and then compile the source code:

  cmake -B build && cmake --build build

You can also use Ninja, if you prefer:

  cmake -B build -G Ninja && cmake --build build

Local installation

You can use the following command to install Amiberry locally:

  cmake --install build

Or combine it with a PREFIX to install it in a specific directory (the default is /usr/local/):

  cmake --install build --prefix /usr

Packaging

The following will create both a TAR.GZ archive and DEB package for Debian-based distros, or a DMG package on macOS:

cpack --config build/CPackConfig.cmake

For more documentation subjects, please check the Wiki page