Amiberry

AmiBerry logo

Turn your Raspberry Pi to an Amiga!

Amiberry is an optimized Amiga emulator for the Raspberry Pi and other ARM-based SoCs, 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 (RetroPie, DietPi, Amibian) and can be installed or upgraded from within their ecosystems. For convenience, 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!

Requirements

  • A Raspberry Pi or other supported ARM based device. The recommended model for the best experience is a Pi 3, as all development is currently tested on that platform first.
  • 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:

Note: If you’re running RetroPie, then Amiberry is already included! Just install it from the menu.

Already have a system you want to keep, but want the Amiberry goodness? No problem.

  1. Get the latest binary release from the Github project page: https://github.com/midwan/amiberry/releases
  2. Make sure you have all the dependencies installed in your system. Check the release page for more details!
  3. 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>)
  4. 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.
  5. 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.
  6. (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.
  7. (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):

Prefer the simpler method of having a pre-built system you just flash and go? Then follow these instructions instead:

  1. Download the image: http://dietpi.com/downloads/images/DietPi_RPi-ARMv6-Jessie_AmiBerry.7z
  2. Write the image to your sdcard (if you’re on Windows, use Win32 Disk Imager or Etcher).
  3. 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
  4. Optionally, to enable OpenSSH, so you can connect and transfer files using that:
    • edit the file /boot/dietpi.txt and locate the following line:
    • AUTO_SETUP_SSH_SERVER_INDEX
      and change it to: AUTO_SETUP_SSH_SERVER_INDEX=-2
  5. Insert the sdcard to your Raspberry Pi
  6. 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.

FAQ

  • 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?
  • 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.

Changelog

Please check the version history on Github.

Credits

The Amiberry bundled distro is powered by the best lightweight Linux distro for the Raspberry Pi: DietPi.dietpi-logo_black

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.