@midwan midwan released this Apr 15, 2018 · 72 commits to master since this release

Assets 7

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.

Mar 25, 2018

@midwan midwan released this Mar 18, 2018 · 109 commits to master since this release

Assets 11

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.