Amiberry

Optimized Amiga Emulator for Linux, macOS, Windows and Android

---

📖 Introduction

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.

Built on the core of WinUAE, Amiberry brings industry-standard compatibility to multiple platforms while adding unique features tailored for modern setups.

✨ Features

• High Performance JIT: Custom Just-In-Time compiler for extreme speed on ARM64 (macOS, Linux, Android) and x86-64 (Linux, macOS, Windows).
• 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.

🚀 Installation

Linux 🐧

Amiberry is available as a .deb (Debian/Ubuntu/Raspberry Pi OS) and .rpm (Fedora/RHEL) package. You can download the latest release from GitHub using this link.

Debian / Ubuntu / Raspberry Pi OS:

# Download the latest .deb from Releases or Development Builds
sudo apt update
sudo apt install ./amiberry_*.deb

Fedora:

# Download the latest .rpm from Releases or Development Builds
sudo dnf install ./amiberry-*.rpm

Flatpak (Flathub):

flatpak install flathub com.blitterstudio.amiberry

Arch Linux (AUR):

yay -S amiberry

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.
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 for maximum performance.

See Compile from Source for build instructions.

Windows 🪟

Amiberry supports Windows x86_64 using MinGW-w64 (GCC).

Releases:

1. Download the latest .zip from Releases.
2. Extract the contents to a directory of your choice.
3. Run Amiberry.exe to start the emulator.

📚 Documentation

For detailed configuration guides, tutorials, and compatibility lists, please visit the Official Wiki.

• First Installation Guide
• Compile from Source
• Troubleshooting

🤝 Contributing

Contributions are welcome! Whether it’s reporting bugs, suggesting features, or submitting Pull Requests, your help makes Amiberry better.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

This project is licensed under the GNU General Public License v3.0 (GPLv3).
See the LICENSE file for details.

---

_{Supported by}