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:
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.
Use the included dietpi-software
tool to find Amiberry for a first installation.
Updates are automatically applied when you run dietpi-update
.
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
(replacerpi3
withrpi2
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.
On all other distros, it should be possible to compile the latest version from source as follows:
- 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 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.
- First Installation
- RetroPie Installation
- Kickstart ROMs (BIOS)
- Upgrading to the latest version
- Frequently Asked Questions
- Default Options
- Supported Platforms