Amiberry v3.1.0

Amiberry v3.1.0 implements the following changes since the previous release:

• Implemented touch support for GUI
• Added NVidia Jetson Nano target
• Fix MDS CD image detection
• Disabled render thread by default on RK3399 for smoother graphics performance (#573)
• Removed special mouse acceleration for Android
• Updated Amiberry logo
• Removed junk files from boot-data.zip #574
• Add faster cycles define for RPI4 64-bit targets
• Implemented #562: Detach mouse with middle mouse button
• Added new target: Odroid Go Advance
• Improved SDL2 config detection
• Implemented Quickstart Model selection as a commandline option (-model=)
• Set write_logfile option to default to "no"
• Added new amiberry.conf options: default_open_gui_key, default_quit_key, rotation_angle
• Increased default GUI window size to 800x600
• Fixed JIT 32-bit bug: ORSR/EORSR/ANDSR, LINK/ULNK (e.g. crashed Modeler.FP on startup)
• Removed obsolete SDL1 files
• Fixed when using rotation angle the resulting image was cropped

Known issues

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

Amiberry v3.0.11

Amiberry v3.0.11 adds the following new features:

• Implemented support for SCP images #555
• Implemented touch control support for the GUI
• Implemented partial touch support (touch down/up events only) inside emulation
• Added Nvidia Jetson Nano target

Additionally, we fixed the following issues:

• Fixed CD32 emulation would not start after v3.0.7 #556
• Old border sprite hack disabled (WinUAE)
• Disabled render thread by default in RK3399 (RockPro64) platforms for smoother graphics #573
• Removed special mouse acceleration setting for Android

Known issues

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

Amiberry v3.0.9

Amiberry v3.0.9 adds the following new features:

• Implemented better support for IPAC controllers
• Allows 2 joysticks to be recognized on one keyboard plugged in, these can be selected in the options. You can now play 2-player amiga games with an iPac arcade cabinet (using retroarch mapping)
• Added a generic setting which overrides the mouse speed for all games, this can be changed in amiberry.conf using input_default_mouse_speed=45. The default is 100 as before.
• Added new option in amiberry.conf: input_keyboard_as_joystick_stop_keypresses=yes, the default is no as before. When using keyboards as joysticks, often the joysticks also pressed keys and caused two inputs across varying games. This setting allows you to disable that behavior.

We also have a new target platform:

• Added LePotato Libre Computer target

And of course, a few bug fixes and improvements:

• Use the first available joystick with Axes/Buttons for GUI control, instead of always joystick 0
• Don't attempt to get Joystick Axis or Button if it's not mapped (set to -1) #542

Known issues

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

Amiberry v3.0.4

Amiberry v3.0.4 brings a few important bugfixes after the v3.0 release.
Please check the version history for full details on the changes made.

Requirements

Please refer to the wiki article regarding First Installation

Upgrading from earlier versions

Please note that from v3.0 onwards, support for SDL1 is removed. Amiberry is now SDL2-only. The Raspberry Pi platform has a special "Dispmanx" version for maximum performance, which also uses SDL2 for everything else except the display.

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.

Amiberry v3.0

Amiberry v3.0 is a big update, which brings a large amount of improvements and bug fixes over the previous versions. Please check the version history for full details on the changes made.

Requirements

Please refer to the wiki article regarding First Installation

Upgrading from earlier versions

Please note that from v3.0 onwards, support for SDL1 is removed. Amiberry is now SDL2-only. The Raspberry Pi platform has a special "Dispmanx" version for maximum performance, which also uses SDL2 for everything else except the display.

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.

Amiberry v2.25

Amiberry v2.25 brings several bug fixes, new features and improvements over the previous versions.
Please check the version history for full details on the changes made.

Which version should I choose?

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

• RPI-only: If you're using a distro based on Raspbian Stretch and you are using the Legacy video driver (e.g. RetroPie on RPI): Use the SDL1 + Dispmanx version. The (non-Dispmanx) SDL2 version also seems to work fine, though it may be slightly slower in performance without the Dispmanx back-end.
• RPI-only: If you're using a distro based on Raspbian Stretch and you are using the FKMS video driver (and have SDL2 compiled): Use the SDL2 + Dispmanx version.
• If you're using the ASUS Tinkerboard, make sure you're running on a kernel with the necessary patches applied and that your distro has the needed libraries for GPU support (e.g. the ROTT image is one good option).
• All other supported platforms have an SDL2 version available in the Makefile.

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 + Dispmanx version, you additionally need the following system packages (from a standard 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 renamed to amiberry.conf and is 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.

Amiberry v2.24

Amiberry v2.24 brings several bug fixes, new features and improvements over the previous versions.
Please check the version history for full details on the changes made.

Which version should I choose?

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

• RPI-only: If you're using a distro based on Raspbian Stretch and you are using the Legacy video driver (e.g. RetroPie on RPI): Use the SDL1 + Dispmanx version.
• RPI-only: If you're using a distro based on Raspbian Stretch and you are using the FKMS video driver (and have SDL2 compiled): Use the SDL2 + Dispmanx version.
• If you're using the ASUS Tinkerboard, make sure you're running on a kernel with the necessary patches applied and that your distro has the needed libraries for GPU support (e.g. the ROTT image is one good option).
• All other supported platforms have an SDL2 version available in the Makefile.

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 + Dispmanx version, you additionally need the following system packages (from a standard 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 renamed to amiberry.conf and is 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.19

Amiberry v2.19

Amiberry v2.19 brings several bug fixes over the previous versions.

Please check the version history for the full details on what changes were made.

There are binaries provided for the Raspberry Pi, ASUS Tinkerboard and Odroid XU4 platforms, in both SDL1 and SDL2 flavors and for both Jessie and Stretch based distros. They are provided in ZIP format, and include the binaries as well as the required folder structure for your kickstarts, configs, etc.

Starting with v2.14, these also include the capsimg.so library, to enable IPF support.
Starting with v2.18, a new directory regarding the whdload booter function is included, whdboot.

Note: The SDL2 versions require that you have the SDL2 libraries 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.
• If you're using the ASUS Tinkerboard, make sure you're running on a kernel with the necessary patches applied and that your distro has the needed libraries for GPU support (e.g. the ROTT image is one good option).

For the other available targets (e.g. XU4), you'll have to compile them from source. 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.18.1

Amiberry v2.18.1

Amiberry v2.18.1 brings several bug fixes, improved audio latency and an exciting new and unique feature: WHDLoad auto-booter!

Please check the version history for the full details on what changes were made.

There are binaries provided for the Raspberry Pi and ASUS Tinkerboard platforms, in both SDL1 and SDL2 flavors and for both Jessie and Stretch based distros. They are provided in ZIP format, and include the binaries as well as the required folder structure for your kickstarts, configs, etc.

Starting with v2.14, these also include the capsimg.so library, to enable IPF support.
Starting with v2.18, a new directory regarding the whdload booter function is included, whdboot.

Note: The SDL2 versions require that you have the SDL2 libraries 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.
• If you're using the ASUS Tinkerboard, make sure you're running on a kernel with the necessary patches applied and that your distro has the needed libraries for GPU support (e.g. the ROTT image is one good option).

For the other available targets (e.g. XU4), you'll have to compile them from source. 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.14

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

There are binaries provided for Raspberry Pi Model 2 and 3 and ASUS Tinkerboard platforms, in both SDL1 and SDL2 flavors, and for Jessie and Stretch based distros.
They are provided in ZIP format, and include the binaries as well as the required folder structure for your kickstarts, configs, etc.

Starting with v2.14, these also include the capsimg.so library, to enable IPF support.

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), 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.