Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Linux Install Instructions
- Compile and Install
- Data Files
- Running Aleph One
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 \ zziplib-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 http://source.bungie.org/download/source.php
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 ./configure
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
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: