# Amiberry **Optimized Amiga Emulator for macOS and Linux** [](https://github.com/BlitterStudio/amiberry/actions/workflows/c-cpp.yml) [](https://nightly.link/BlitterStudio/amiberry/workflows/c-cpp.yml/master) [](https://discord.gg/wWndKTGpGV) [](https://mastodon.social/@midwan) [](https://ko-fi.com/X8X4FHDY4)

---

📖 Introduction

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

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

✨ Features

• High Performance JIT: Custom Just-In-Time compiler for extreme speed on supported devices.
• 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.
• 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.

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.

📚 Documentation

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

• First Installation Guide
• Compile from Source

🤝 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}