Turn your Raspberry Pi to an Amiga!
Amiberry is an optimized Amiga emulator for the Raspberry Pi model 1, Zero, 2 and 3, 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.
Besides the emulator, we also offer a complete pre-configured distro, which boots directly into Amiga emulation. Check out the specifics for the distro itself:
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!
- A Raspberry Pi. The recommended model for the best experience is a Pi 3. It will also work with a Pi 2, Pi 1 or even a Pi Zero, with all the features enabled (yes, including Picasso96 support!).
- A network connection. That can be either the Pi’s built-in Ethernet or a Wifi adapter (or the built-in WiFi of the Pi 3). This is needed for the initial installation at least, it’s optional after that.
Installation (if you only want the emulator):
Note: If you’re running RetroPie, then Amiberry is already included!
Already have a system you want to keep, but want the Amiberry goodness? No problem.
- 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.
- (Optional) If you want to use WHDLoad based games, check out the excellent tool UAE Config Maker by Dom Cresswell, at the Ultimate Amiga guides section.
- (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!
Installation (if you want the complete distro):
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-AmiBerry_RPi-armv6-(Jessie).7z
- Write the image to your sdcard (if you’re on Windows, use Win32 Disk Imager).
- Plug in the Ethernet cable OR optionally set the Wifi connection details in the /boot/dietpi.txt file on the sdcard:
- Set Wifi_Enabled=1
- Set Wifi_SSID=MyWirelessSSID
- Set Wifi_KEY=MyAccessKey
- Set Wifi_country_code= This will enable channels and higher power ratings allowed for your country. Example country codes are:
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_DietpiSoftware_SSHServerIndex=-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.
- Added more Picasso resolutions
- Fixed bugs related to video and audio glitches
- Added mapping option for keyboard key to Quit the emulator directly
- Added mapping option for game controller button to a) Enter GUI and b) Quit the emulator
- Added Shutdown button, to power off the (host) computer
- Fixed bugs and crashes in GUI keyboard navigation
- Loading the Configuration file now respects the input settings
- Removed Pandora specific keyboard shortcuts which caused crashes
- FullHD (1080p) resolution supported in Picasso96 mode on all Pi models – Pi Zero / Pi 1 version now has full Picasso96 support (up to 1080p 32-bit)
- Internal Code formatting and cleanup
- Added support for custom functions assignable to keyboard LEDs (e.g. HD activity)
- Updated core from the latest Pandora port
- Reworked from the ground up to be smaller, faster, better!
- Joint effort with DietPi so it can be used as a base for a complete distro instead of Minibian.
- Integrated into DietPi’s software menu as well, so it can be installed either from a dedicated Amiberry image or through a normal DietPi one.
- Uses the rich DietPi infrastructure and features, taking advantage of auto-updates, external USB storage, etc.
- Custom emulator compile, to include several improvements and bug fixes. Improvements include a Pi 3 optimized build, support for Caps/Num/Scroll Lock LEDs, configurable LEDs in the menu, and more!
- Initial release, based on Minibian.
- Hand-optimized booting sequence, to achieve the fastest possible boot time directly into emulation.
- Custom menu tool included, to help manage system settings, configuration, auto-updates etc.
- Uses uae4arm-rpi as the emulator.
The Amiberry 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.
Logo created by Thomas Navarro Garcia.