v2.13

Version 2.13 brings some new features, bug fixes and improvements. Please check the
version history for the full details.

There are binaries provided for all Raspberry Pi (Model 1, 2, 3 and Zero/W) platforms, in both SDL1 and SDL2 flavors.
The are provided in ZIP format, and include the binaries as well as the required folder structure for your kickstarts, configs, etc.

Please note that the SDL2 versions require that you have SDL2 installed in your system, as per the Wiki instructions.

Which version should I choose?

There are multiple versions available in an attempt to get the best possible performance out of your system:

• If you're using a distro based on Raspbian Jessie and you are using the Legacy video driver (e.g. RetroPie): Use the Jessie SDL1 + Dispmanx version.
• If you're using a distro based on Raspbian Stretch and you are using the Legacy video driver: Use the Stretch SDL1 + Dispmanx version
• If you're using a distro based on Raspbian Stretch and you are using the FKMS video driver (and have SDL2 compiled): Use the Stretch SDL2 + Dispmanx version

For the other supported targets (e.g. XU4, Tinkerboard), you'll have to compile them from source for now.
Since some may have special requirements, please consult the relevant pages in the Wiki first!

Requirements

• You have to provide your own Amiga Kickstart ROMs. You can use the encrypted Amiga Forever ones as well, if you include the "key.rom" file with them in the same directory.

• Common required packages for all versions (use sudo apt-get install):

  libxml2-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev
  

• If you want to run the SDL1 version, you additionally need the following system packages (from a standard Jessie/Stretch system):

  libsdl-dev libguichan-dev libsdl-ttf2.0-dev libsdl-gfx1.2-dev
  

• If you want to run the SDL2 version, you additionally need the SDL2, SDL2_ttf and SDL2_image packages compiled from source, as per the instructions in the relevant Wiki page.

Upgrading from earlier versions

Please note that if you're upgrading from v2.1, there have been new additions and changes in the following areas:

• Config files have new options and some options have been renamed for clarity. Older config files may or may not work correctly, depending on their content. If possible, we recommend you recreate them if you run into problems.
• The adfdir.conf file which is normally auto-generated on the first run, has been updated to contain more information. We recommend you delete the file and allow Amiberry to recreate it, especially if you run into problems.
• There are new files in the data/ subdirectory, which are required for the emulator to startup. Please make sure you copy those in the right place, if you're manually copying the binary over an existing installation.

Known issues

Please consult the open Issues for an up-to-date list

Found a new bug?

Great! Let's get it fixed and make the emulator even better!
Please submit a new Issue using the provided template, providing as many details as needed to recreate the problem.

v2.12

Version 2.12 brings a lot of new features, bug fixes and improvements. Please check the
version history for the full details.

There are binaries provided for RPI3 and RPI2 platforms, in both SDL1 and SDL2 flavors.
The are provided in both TGZ and ZIP format, for convenience (the contents are identical).
Please note that the SDL2 versions require that you have SDL2 installed in your system, as per the Wiki instructions.

Which version should I choose?

There are multiple versions available in an attempt to get the best possible performance out of your system:

• If you're running Jessie and you are using the Legacy video driver (e.g. RetroPie): Use the Jessie SDL1 + Dispmanx version.
• If you're running Stretch and you are using the Legacy video driver: Use the Stretch SDL1 + Dispmanx version
• If you're running Stretch and you are using the FKMS video driver (and have SDL2 compiled): Use the Stretch SDL2 + Dispmanx version

For the other supported targets, you'll have to compile them from source for now.

Requirements

• You have to provide your own Amiga Kickstart ROMs. You can use the encrypted Amiga Forever ones as well, if you include the "key.rom" file with them in the same directory.

• Common required packages for all versions (use sudo apt-get install):

  libxml2-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev
  

• If you want to run the SDL1 version, you additionally need the following system packages (from a standard Jessie/Stretch system):

  libsdl-dev libguichan-dev libsdl-ttf2.0-dev libsdl-gfx1.2-dev
  

• If you want to run the SDL2 version, you additionally need the SDL2, SDL2_ttf and SDL2_image packages compiled from source, as per the instructions in the relevant Wiki page.

Upgrading from earlier versions

Please note that in this version, there have been new additions and changes in the following areas:

• Config files have new options and some options have been renamed for clarity. Older config files may or may not work correctly, depending on their content. If possible, we recommend you recreate them if you run into problems.
• The adfdir.conf file which is normally auto-generated on the first run, has been updated to contain more information. We recommend you delete the file and allow Amiberry to recreate it, especially if you run into problems.
• There are new files in the data/ subdirectory, which are required for the emulator to startup. Please make sure you copy those in the right place, if you're manually copying the binary over an existing installation.

Known issues

Please consult the open Issues for an up-to-date list

Found a new bug?

Great! Let's get it fixed and make the emulator even better!
Please submit a new Issue using the provided template, providing as many details as needed to recreate the problem.

v2.11

Version 2.11 brings a lot of new features, bug fixes and improvements. Please check the
version history for the full details.

There are binaries provided for RPI3 and RPI2 platforms, in both SDL1 and SDL2 flavors.
The are provided in both TGZ and ZIP format, for convenience (the contents are identical).
Please note that the SDL2 versions require that you have SDL2 installed in your system, as per the Wiki instructions.

Which version should I choose?

There are multiple versions available in an attempt to get the best possible performance out of your system:

• If you're running Jessie and you are using the Legacy video driver (e.g. RetroPie): Use the Jessie SDL1 + Dispmanx version.
• If you're running Stretch and you are using the Legacy video driver: Use the SDL1 + Dispmanx version
• If you're running Stretch and you are using the FKMS video driver (and have SDL2 compiled): Use the SDL2 + Dispmanx version

For the other supported targets, you'll have to compile them from source for now.

Requirements

• You have to provide your own Amiga Kickstart ROMs. You can use the encrypted Amiga Forever ones as well, if you include the "key.rom" file with them in the same directory.

• Common required packages for all versions (use sudo apt-get install):

  libxml2-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev
  

• If you want to run the SDL1 version, you additionally need the following system packages (from a standard Jessie/Stretch system):

  libsdl-dev libguichan-dev libsdl-ttf2.0-dev libsdl-gfx1.2-dev
  

• If you want to run the SDL2 version, you additionally need the SDL2, SDL2_ttf and SDL2_image packages compiled from source, as per the instructions in the relevant Wiki page.

Upgrading from earlier versions

Please note that in this version, there have been new additions and changes in the following areas:

• Config files have new options and some options have been renamed for clarity. Older config files may or may not work correctly, depending on their content. If possible, we recommend you recreate them if you run into problems.
• The adfdir.conf file which is normally auto-generated on the first run, has been updated to contain more information. We recommend you delete the file and allow Amiberry to recreate it, especially if you run into problems.
• There are new files in the data/ subdirectory, which are required for the emulator to startup. Please make sure you copy those in the right place, if you're manually copying the binary over an existing installation.

v2.1

This release is based on "uae4arm-rpi" but with several improvements, including:

• 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
• Pi 3 is now the default target if no Platform is specified
• Optimizations for Pi 3 added
• New target platform: Pi 3

The full package below contains everything needed (including data files and all 3 binaries, one for each Pi platform), but there are also separate binary-only zip packages provided.
Binaries are provided for Raspbian-based distros (tested on Raspbian, Raspbian Lite and RetroPie).
DietPi-based "Amiberry" distros can also get the upgrade through DietPi's update system automatically.

Install requirements by running:
sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-gfx1.2-5 libsdl-ttf2.0-0 libmpg123-0 libguichan-sdl-0.8.1-1 libxml2

Please report any bugs in the Issues page!