Amiberry

Optimized Amiga Emulator for Linux, macOS and Windows

---

📖 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 and Windows, 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 multiple 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.

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

ARM64 JIT diagnostics

On ARM64 hosts, JIT includes runtime safety guards for known unstable startup paths.

• AMIBERRY_ARM64_GUARD_VERBOSE=1 enables detailed guard-learning logs (diagnostic use).
• Optional ARM64 hotspot guard is now disabled by default for performance.
• AMIBERRY_ARM64_ENABLE_HOTSPOT_GUARD=1 re-enables optional hotspot guard logic for A/B testing.
• AMIBERRY_ARM64_DISABLE_HOTSPOT_GUARD=1 forces optional hotspot guard off; fixed safety fallback for the known startup hotspot remains active.

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