https://github.com/blitterstudio/amiberry
Optimized Amiga emulator for Linux/macOS
https://github.com/blitterstudio/amiberry
amiberry amiga amiga-emulator arm emulation emulator raspberry-pi rpi sdl
Last synced: 20 days ago
JSON representation
Optimized Amiga emulator for Linux/macOS
- Host: GitHub
- URL: https://github.com/blitterstudio/amiberry
- Owner: BlitterStudio
- License: gpl-3.0
- Created: 2016-08-11T11:28:22.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-06-19T15:09:15.000Z (10 months ago)
- Last Synced: 2025-06-21T13:04:03.845Z (10 months ago)
- Topics: amiberry, amiga, amiga-emulator, arm, emulation, emulator, raspberry-pi, rpi, sdl
- Language: C++
- Homepage: https://amiberry.com
- Size: 78.5 MB
- Stars: 746
- Watchers: 49
- Forks: 93
- Open Issues: 18
-
Metadata Files:
- Readme: docs/README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Authors: AUTHORS
Awesome Lists containing this project
README
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](https://www.winuae.net), 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](https://github.com/BlitterStudio/amiberry/releases/latest).
**Debian / Ubuntu / Raspberry Pi OS:**
```bash
# Download the latest .deb from Releases or Development Builds
sudo apt update
sudo apt install ./amiberry_*.deb
```
**Fedora:**
```bash
# Download the latest .rpm from Releases or Development Builds
sudo dnf install ./amiberry-*.rpm
```
**Flatpak (Flathub):**
```bash
flatpak install flathub com.blitterstudio.amiberry
```
**Arch Linux (AUR):**
```bash
yay -S amiberry
```
### macOS 🍎
Amiberry supports both Intel (x86_64) and Apple Silicon (M1/M2/M3).
**Via Homebrew:**
```bash
brew install --cask amiberry
```
**Via DMG:**
1. Download the latest `.dmg` from [Releases](https://github.com/BlitterStudio/amiberry/releases/latest).
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](https://github.com/BlitterStudio/amiberry/wiki/Compile-from-source) for build instructions.
### Windows 🪟
Amiberry supports Windows x86_64 using MinGW-w64 (GCC).
**Releases:**
1. Download the latest `.zip` from [Releases](https://github.com/BlitterStudio/amiberry/releases/latest).
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](https://github.com/BlitterStudio/amiberry/wiki)**.
- [First Installation Guide](https://github.com/BlitterStudio/amiberry/wiki/First-Installation)
- [Compile from Source](https://github.com/BlitterStudio/amiberry/wiki/Compile-from-source)
- [Troubleshooting](https://github.com/BlitterStudio/amiberry/wiki/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](LICENSE) file for details.
---
Supported by
