Skip to content

BlitterStudio/amiberry

Repository files navigation

Optimized Amiga emulator for multiple platforms

ko-fi

Follow me on Mastodon!

C/C++ CI

Discord

Amiberry logo

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

Linux

Amiberry is available as a Flatpak, DEB and RPM package for ARM32, ARM64 (aarch64) and x86_64 Linux platforms. You can download the latest version from the Releases area.

A flatpak version is available on Flathub

For DEB packages:

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

Or the RPM package:

  sudo dnf install ./amiberry-7.0.0-1.x86_64.rpm

Or just use the graphical front-end your distro provides (double clicking on the DEB/RPM package should do that)

If you're 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. Alternatively, macOS might ask you about allowing it to run, and you'll have to manually do that (the exact steps differ from one macOS version to another).

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.

Compile from source

Alternatively, you can compile the latest version of Amiberry from source.

For more documentation subjects, please check the Wiki page