Upgrading to the latest version

Depending on what distro you're running on, Amiberry can be upgraded to the latest version by following these steps:

RetroPie

Use the included RetroPie-Setup tool and find Amiberry under the "Optional" packages.

You can use either "Update from binary" or "Update from source" to get the latest version. Please note that "Update from binary" will get you a binary version that the RetroPie team has compiled, so we have no control over that.

DietPi

Use the included dietpi-software tool to find Amiberry for a first installation. Updates are automatically applied when you run dietpi-update.

---

Amibian (up to v1.4)

You can either use the binary ZIP archive in the release (https://github.com/midwan/amiberry/releases), or compile the latest from source.

Amibian already includes a clone of this repo, under ~/amibian/amiberry/amiberry. You can upgrade to the latest version by following these steps:

• cd amibian/amiberry/amiberry
• git fetch
• clear out a file that shouldn't be there: rm CMakeLists.txt
• git pull

and then proceed to compile as usual, with:

• make -j2 PLATFORM=rpi3 (replace rpi3 with rpi2 if you're running on an RPI2 of course)

when it's finished compiling, copy the resulting file in the location Amibian expects it:

• cp amiberry ..

That's it, you can now launch the emulator as usual.

---

Manual way

On all other distros, it should be possible to compile the latest version from source as follows:

If this is the first time you're doing this

• Clone this repo: git clone https://github.com/BlitterStudio/amiberry amiberry-master
• Enter the newly created directory: cd amiberry-master

If you already had cloned the repo before, you don't have to do that again. Instead, you can do this:

• Enter the previously cloned directory: cd amiberry-master
• Download the latest source updates: git pull

Compile the sources

• Compile for your target (e.g. for 64-bit RPI4 using SDL2 with Dispmanx): make -j4 PLATFORM=rpi4-64-dmx. Please consult the relevant Wiki page for the full list of available platforms. Alternatively, you can also check the Makefile itself for a full list of supported platforms.
• When the process is finished, if no error has occurred, you should have a file named amiberry compiled in the same directory.
• Assuming you have your production environment in ~/amiberry, you can do cp amiberry ~/amiberry, to copy the binary in that location.

Please note that in some cases, there may be extra files added in new releases, and those should be copied over too. For example, new directories, or new files inside existing directories (e.g. data/). Check the release notes or compare the directory contents, if you are unsure.