Compile from source

Compiling Amiberry from source

Linux

You'll need the -dev version of the required packages. For example, on Debian-based distros:

  sudo apt install cmake libsdl2-dev libsdl2-ttf-dev libsdl2-image-dev libflac-dev libmpg123-dev libpng-dev libmpeg2-4-dev libserialport-dev libportmidi-dev

Or if you're using an Arch-based distro (e.g. Manjaro), the relevant packages are:

  sudo pacman -S base-devel cmake sdl2 sdl2_ttf sdl2_image flac mpg123 libmpeg2 libserialport portmidi

macOS

Under macOS, you will need to install the required libraries using Homebrew:

    brew install cmake sdl2 mpg123 sdl2_ttf sdl2_image flac libmpeg2 libserialport portmidi dylibbundler wget

Clone this repository locally

  git clone https://github.com/BlitterStudio/amiberry
  cd amiberry

Build Amiberry

Amiberry requires CMake to build. The following commands will create a build directory, configure the build, and then compile the source code:

  cmake -B build && cmake --build build

You can also use Ninja, if you prefer:

  cmake -B build -G Ninja && cmake --build build

Note: The default install PREFIX that CMake uses, is /usr/local/. Amiberry will use that internally, so if you want to change it, you should specify one during the configure stage.

E.g. for installing things under /opt, like the DEB package does, you should use:

cmake -B build -G Ninja -DCMAKE_INSTALL_PREFIX=/usr && cmake --build build

Local installation

You can use the following command to install Amiberry locally:

  sudo cmake --install build

Or combine it with a PREFIX to install it in a specific directory (the default is /usr/local/):

  sudo cmake --install build --prefix /opt

Packaging

The following will create both a TAR.GZ archive and DEB package for Debian-based distros, or a DMG package on macOS:

cpack --config build/CPackConfig.cmake