Linux Install Instructions

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

Overview

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.

Prerequisites

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

Fedora

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.

Ubuntu

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

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

Configure

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:

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:

unzip Marathon-20150619-Data.zip

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/