Skip to content

Amiberry v2.24
Compare
Choose a tag to compare
@midwan midwan released this 14 Jan 18:47
· 5563 commits to master since this release
v2.24
22b9501

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.

Assets 3
Loading