Home

Welcome to the Amiberry wiki!

Amiberry

Optimized Amiga Emulator for macOS, Linux, Windows and Android

---

Amiberry is an optimized Amiga emulator designed for ARM (32/64-bit), x86_64, and RISC-V platforms. It natively runs on Linux, macOS, Windows and Android, providing a high-performance emulation experience suitable for everything from low-power SBCs (like Raspberry Pi) to powerful desktop workstations and mobile devices.

✨ Features

• High Performance JIT: Custom Just-In-Time compiler for extreme speed on ARM64 (macOS, Linux, Android) and x86.
• WHDLoad BOOTER: Native support for launching WHDLoad titles directly, handling all configuration automatically.
• RetroArch Integration: Seamless mapping for RetroArch controllers.
• Host Tools Integration: Launch host applications directly from the emulation.
• Dynamic File Handling: Drag-and-drop support for floppies, hardfiles, and config files.
• Custom Bezel Overlays: Use your own bezel PNG images (e.g., CRT monitor frames) with any shader. The emulator output is automatically fitted to the bezel's transparent screen area.
• Native GUI: A responsive, feature-rich interface designed for both mouse and controller navigation.
• Auto-Update: Built-in update checker that detects new releases and downloads them directly — with SHA256 verification.

🚀 Getting Amiberry

Linux 🐧

Via package repository (recommended — automatic updates):

curl -fsSL https://packages.amiberry.com/install.sh | sudo sh
sudo apt install amiberry      # Debian / Ubuntu / Raspberry Pi OS
sudo dnf install amiberry      # Fedora

The repository at packages.amiberry.com supports Ubuntu 22.04/24.04/25.10, Debian 12/13, and Fedora. Once set up, apt upgrade or dnf update will deliver future releases automatically.

Via Ubuntu PPA:

sudo add-apt-repository ppa:midwan-a/amiberry
sudo apt update && sudo apt install amiberry

Via Fedora COPR:

sudo dnf copr enable midwan/amiberry
sudo dnf install amiberry

Via Flatpak (Flathub):

flatpak install flathub com.blitterstudio.amiberry

Via Arch Linux (AUR):

yay -S amiberry

Manual download: Download the latest .deb or .rpm from the Releases page or grab the latest Development Builds.

macOS 🍎

Amiberry supports both Intel (x86_64) and Apple Silicon (M1/M2/M3).

Via Homebrew:

brew install --cask amiberry

Via DMG:

1. Download the latest .dmg from Releases or Development Builds.
2. Open the disk image.
3. Drag Amiberry.app to your Applications folder.

Note: For development builds, file associations for .uae, .adf, and .lha are set up automatically.

Android 🤖

Amiberry supports Android on AArch64 and x86_64, with full ARM64 JIT support.

See Compile from Source for build instructions.

📚 Documentation

Detailed guides and compatibility lists are available in the sidebar pages.

• Quick Start Guide
• Compile from Source
• WHDLoad Workflow
• Input Mapping Guide