Turn your Raspberry Pi to an Amiga!
Amiberry is an optimized Amiga emulator for ARM-based SoCs (such as the Raspberry Pi, Odroid XU4, ASUS Tinkerboard, etc.), that brings you the highest performance Amiga emulation. Be it a classic A500, A1200, CD32 or up to a high-end model equipped with a 68040 and a graphics card, we’ve got you covered.
It’s an open-source project, build with the efforts of several people and based on previous work of others. You are welcome to join the effort and help make Amiberry the best Amiga emulator for ARM devices! Visit the project page on Github for more.
Amiberry is already included in several popular distros (like RetroPie, DietPi, Amibian and others) and can be installed or upgraded from within their ecosystems. Additionally, you can of course install it on a standard Linux distro (e.g. Raspbian, Ubuntu, Arch). For convenience, we also offer a complete pre-configured distro (based on DietPi), which boots directly into Amiga emulation.
Check out the specifics for the custom-built distro:
It’s fast! The image is hand-optimized to boot directly in Amiga emulation as fast as possible. No boot messages, no logos, no noise – just like a real Amiga.
It’s small! The image is just over 500MB so it can easily fit in a 1GB sdcard. Though you probably want some more space, if you’re planning to store your Amiga files on it.
It’s powerful! Amiberry is running on top of best lightweight Linux distro running underneath – DietPi. You can take advantage of all the unique features it provides, such as the excellent auto-update system, external USB storage, etc. You can read all about what you can do with DietPi at the official site.
It’s flexible! You can install it using the image file below. Or you can install a normal DietPi image, and later choose to setup Amiberry from within it’s menu. If you ever want to stop it from autobooting into Amiga emulation, you can always disable it from DietPi’s menu. It’s yours to configure any way you want it!
If you like this project, you can help further development by donating any amount you can: https://paypal.me/pools/c/8apqkBQovm
Donations go towards getting new devices to port Amiberry to, covering some of the costs, keeping the motivation for the countless hours of work involved in the project, etc.
- A Raspberry Pi or other supported ARM based device (e.g. Odroid XU4, ASUS Tinkerboard, etc.). The faster the better, Amiga emulation is quite demanding.
- A network connection. That can be either your board’s built-in Ethernet or a WiFi adapter. This is needed for the initial installation at least, it’s optional after that.
Note: If you’re running RetroPie, then Amiberry is already included! Just install it from the “RetroPie-Setup” menu.
Already have a system you want to keep, but want the Amiberry goodness? No problem. We have binary releases as well.
- Get the latest binary release from the Github project page: https://github.com/midwan/amiberry/releases
- Make sure you have all the dependencies installed in your system. Check the release page for more details!
- Extract the archive and place the emulator executable where you want. Remember to set the flags to execute on it, if necessary (e.g. chmod a+x <filename>)
- You’ll need to bring your own Kickstart ROMs, as they are protected under copyright. If you’ve bought Amiga Forever, you can also use those ROMs, but remember to also copy the “rom.key” file in the same directory, as those are encrypted.
- You can use ADF disks, HDF hard file images, normal directories/files as virtual Amiga Hard drives, etc. Just set up your configuration from within the emulator and start having fun.
- New feature: Amiberry now also supports WHDLoad games directly, and can load them using our own custom boot loader. You can check the documentation on how to use this feature in the official Wiki page: https://github.com/midwan/amiberry/wiki/WHDLoad-Auto-booting
- (Optional) If you want to test out the latest developments which are not ready for release, you can get the “dev” branch from Github instead. Warning: you’ll need to compile it from source, so you should be comfortable with that!
Installing the pre-configured distro (based on DietPi):
Note: The image below is still based on an older version (Stretch), and is not yet compatible with the newer RPI4 (which requires Buster). For now, it’s recommended you get the latest DietPi image directly instead, and install Amiberry from within its menu.
Prefer the simpler method of having a pre-built system you just flash and go? Then follow these instructions instead:
- Download the image: http://dietpi.com/downloads/images/DietPi_RPi-ARMv6-Stretch_AmiBerry.7z
- Write the image to your sdcard (if you’re on Windows, use Win32 Disk Imager or Etcher).
- Plug in the Ethernet cable OR optionally set the Wifi connection details in the /boot/dietpi.txt file on the sdcard:
- Set AUTO_SETUP_NET_WIFI_ENABLED=1
- Set AUTO_SETUP_NET_WIFI_SSID=MyWirelessSSID
- Set AUTO_SETUP_NET_WIFI_KEY=MyAccessKey
- Set CONFIG_WIFI_COUNTRY_CODE= This will enable channels and higher power ratings allowed for your country. Example country codes are: GB US DE JP. Full list: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
- Save changes
- Optionally, to enable OpenSSH, so you can connect and transfer files using that:
- edit the file /boot/dietpi.txt and locate the following line:
and change it to: AUTO_SETUP_SSH_SERVER_INDEX=-2
- Insert the sdcard to your Raspberry Pi
- Power on and watch the magic.
DietPi will take care of installing everything that is needed the first time it boots, including expanding the filesystem. When it’s finished, Amiberry will auto-start at boot. Please be patient during the initial installation and configuration steps!
After installation, please refer to the instructions here.
- How can I connect to the Pi to transfer my files?
- For now, the image comes with a very lightweight configuration by default (this might change with an update). No file server is enabled and it uses Dropbear as the SSH server. You can enable either a File server such as FTP or Samba, or the full SSH Server if you want. To do that, you’ll need to run “dietpi-software” from the console and select to install the relevant service you want from the menu.
- Ok, I’ve enabled OpenSSH as my SSH Server, so I can connect now. What credentials can I use?
- The default ones from DietPi apply: root/dietpi
- I can connect to the Pi! Where should I place my Amiga software so it can be used from the emulator?
- The default location is in /mnt/dietpi_userdata/uae4arm-rpi/ which can point to either your SD card or an external USB device, depending on how you want DietPi configured. The default location is the internal SD card.
- But I don’t want to use SSH to connect. Can’t I use something else?
- You can optionally enable an FTP server (faster, recommended) or even a Samba server (slower performance), using the “dietpi-software” menu options. For more information, check the official DietPi page on the subject.
- I found a problem. What can I do?
- We’re sorry about that! To do our best and fix it, it would be great if you could report it in detail, including the steps to recreate it, by opening a new issue here.
- I have an idea on how to make this better. What can I do?
- Great! Feedback always helps in improving things and it’s more than welcome. Please open a new issue here and describe your idea/suggestion.
Please check the version history on Github.
The Amiberry bundled distro is powered by the best lightweight Linux distro for the Raspberry Pi: DietPi.
RetroPie feedback, support and guides can be found on the Amiga RetroPie WHDLoad group on Facebook.
This project was originally inspired by Amibian, by Gunnar Kristjánsson.
Original ideas and support from the Retro Emulation Facebook group.
Name idea from Vasiliki Soufi.
Amiberry logo created by Thomas Navarro Garcia.