-
-
Notifications
You must be signed in to change notification settings - Fork 99
Linux Install Instructions
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 SDL2-devel SDL2_ttf-devel SDL2_image-devel SDL2_net-devel \
speex-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 libsdl2-dev \
libsdl2-image-dev libsdl2-net-dev libsdl2-ttf-dev \
libspeexdsp-dev libzzip-dev libavcodec-dev libavformat-dev \
libavutil-dev libswscale-dev libpng-dev libcurl4-gnutls-dev
Download the latest Aleph One source package from the GitHub release page, or use this link: latest stable source. You can also get the latest stable release at the command line:
curl -o AlephOne-stable.tar.bz2 -L https://alephone.lhowon.org/download/source.php
tar xjvf AlephOne-stable.tar.bz2
First, run the configure script. This will detect the various libraries installed on your computer.
cd AlephOne-20181006
./configure
(If you are using a GitHub checkout or snapshot instead of a packaged release, you will need to run ./autogen.sh instead.)
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: system libexpat
Enabled: SDL2_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".
If FFmpeg support is enabled, it will be used instead of libmad, libsndfile, libvorbis, and SMPEG. Any errors with those libraries can be ignored. If FFmpeg is disabled or unavailable, those other libraries will be used to support various media types and features. Aleph One 1.3 and later require smpeg2.
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.
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-20181006-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/
To launch a particular scenario, point the executable to the location of the data files like so:
/usr/local/bin/alephone ~/AlephOneData/Marathon/