Linux Install Instructions

Jeremiah Morris edited this page Jan 16, 2016 · 2 revisions


To run Aleph One on Linux, you'll need to compile the engine on your computer. This guide will walk you through the prerequisites, downloading and compiling the Aleph One source code, and installing the data files needed for scenarios.


To compile Aleph One, you'll need various prerequisite packages installed.


First, enable the RPM Fusion Repository.

Then, install the following packages.

sudo dnf install boost-devel curl-devel ffmpeg-devel gcc-c++ libpng-devel \
  SDL-devel SDL_ttf-devel SDL_image-devel SDL_net-devel speexdsp-devel \

As an alternative to using FFmpeg (which requires the RPM Fusion Repository), you can install alternative libraries:

sudo dnf install libsndfile-devel libvorbis-devel

If you don't compile with FFmpeg support, you won't be able to use WebM export in Aleph One.


Run this command to install the necessary prerequisites for building Aleph One:

sudo apt-get install libboost-all-dev libsdl1.2-dev libsdl-image1.2-dev \
  libsdl-net1.2-dev libsdl-ttf2.0-dev libspeexdsp-dev libzzip-dev \
  libavcodec-dev libavformat-dev libavutil-dev libswscale-dev


Download the latest Aleph One source package using your web browser or from the command-line:

curl -o AlephOne-20150619.tar.bz2 -L

Unpack the source archive.

tar xjvf AlephOne-20150619.tar.bz2


First, run the configure script. This will detect the various libraries installed on your computer.

cd AlephOne-20150619

Once the script finishes, you should see a summary of the options found:

Summary of optional features:

    Enabled: OpenGL rendering
    Enabled: built-in Lua scripting
    Enabled: SDL_image support
    Enabled: FFmpeg playback and film export
  Not found: libmad MP3 playback
  Not found: libsndfile audio decoding
  Not found: libvorbis Ogg/Vorbis music playback
  Not found: SMPEG movie playback
    Enabled: Speex net mic playback
    Enabled: ALSA net mic transmission
    Enabled: cURL for HTTP communication
    Enabled: zziplib support
    Enabled: libpng PNG screenshot support

Configuration done. Now type "make".

Compile and Install

After running the configure script, start the compile process by running make:


Once the compile is finished, you can install the executable by running:

sudo make install

By default, the Aleph One executable is installed into /usr/local/bin/alephone.

Data Files

You will need to download the data files for each scenario you want to play from the Aleph One Scenarios page. After downloading a scenario archive, unzip it:


You may want to organize your scenario data. In this example, we put the scenarios into a home folder called AlephOneData:

mkdir ~/AlephOneData/
mv Marathon/ ~/AlephOneData/

Running Aleph One

To launch a particular scenario, point the executable to the location of the data files like so:

/usr/local/bin/alephone ~/AlephOneData/Marathon/
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.