First Installation

Requirements

• Raspbian Jessie or later (might work on other distros as well, but this is what is mostly tested against)
• SDL1 (Raspberry Pi only!) or SDL2 (any platform)
• SDL1: Legacy or FKMS driver (for Raspberry Pi)
• SDL2: Any supported driver for your system (note: if you want to run it from the console on the Raspberry Pi, you need to compile SDL2 from source - see https://github.com/midwan/amiberry/wiki/Compile-SDL2-from-source)

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.

So many targets, which one should I pick?

We have several targets available to cover different scenarios. As a rule of thumb, you can follow the below guide to choose the right one for you:

If you're using a Raspberry Pi:

• Are you using the Legacy video driver? Then pick SDL1 + Dispmanx
• Are you using the FKMS video driver? Either SDL1 + Dispmanx or SDL2 + Dispmanx (note: you'll have to compile SDL2 from source to with --disable-video-rpi --enable-video-kmsdrm).
• Are you using the Full KMS driver and/or want to run it windowed under X11? Pick the SDL2 target.

If you're using another board:

• There's no Dispmanx target (it's specific to RPI), so just pick the SDL2 target for your platform

If your platform doesn't have a dedicated target in the Makefile:

• Depending on your platforms architecture (CPU, FPU, GPU), one of the existing SDL2 targets might work for you. You'll have to experiment a bit and see.

If you want your platform added in the list of officially supported targets:

• We'd be happy to have Amiberry running on as many devices as possible. Please donate a board for development and we can try to port Amiberry on it!