GNU/Linux Instructions

No binary packages of Gusanos are available at this time, and everything must be built from source.

Downloading Source

The source code must be downloaded from the Gusanos CVS repositry hosted on

To download the source code, use the program 'CVS', like this:

cvs -z3 co ./

That will download all files to the present working directory so make sure you create a dedicated directory first (~/gusanos).

Building Gusanos

Gusanos has a few dependancies which are required to be installed appropriately on the system in order to build (& run) Gusanos. These dependancies include:

  • GCC - C/C++ compiler (>= 3.4 – 3.3 won't do! Preferably 4.0)
  • Allegro - Game library (>= 4.2.0)
  • Boost - C++ libraries (>= 1.33 - You'll need libboost-filesystem and libboost-signals.)
  • fmod - Sound library (>= 3.74 - You can get it here)
  • Zoidcom - Networking library (0.6.x Get it here)
  • SCons - Software construction tool (⇐ 0.96.1)
  • re2c - Tool for generating fast C-based recognizers (or use 'scons no-parser=yes') [note: in my experience re2c is mandatory, if not a compile error will come up because one of the .h files was not properly generated]

If you want to run a dedicated server on a linux box that has no X (only SSH access) you might need to get the SVN version of Allegro from the 4.2 branch, otherwise allegro_init() will fail and Gusanos will segfault.

For more instructions on how to install these software, check your distro package database or see the website for build instructions.

Gentoo users can simply do:

emerge allegro fmod boost scons re2c

Note that Zoidcom (the networking lib) is closed source and not really popular, so most distros won't distribute it. To install it download the Linux version from the website ( and then copy the include and lib files manually to your system directories (generally /usr/include and /usr/lib).

Note: There is no fmod for 64-bit linux as of the time of this edit, so if you are using a 64-bit system, you're going to have to compile in a 32-bit chroot or in a 32-bit system. Personal comment: This sucks. Why not use a decent free sound library instead of this proprietary shit? Personal comment: Probably because FMOD simply rocks. Personal question: have you tried FLESSD, it is a free (open-source) FMOD rewrite, and the functions are named the same, it's not complete, but maybe enough for Gusanos

You might also need to create a few symlinks to libs that scons fails to find:

ln -s /usr/lib/ /usr/lib/
ln -s /usr/lib/ /usr/lib/
ln -s /usr/local/lib/ /usr/local/lib/
ln -s /usr/lib/ /usr/lib/
ln -s /usr/local/lib/ /usr/local/lib/

To build Gusanos, just change to the Gusanos top directory and run:



scons no-parsers=1

This should build a Gusanos and place an executable binary in bin/posix/.

Adding the data

As CVS only contains the code, the data must be added: get the zip for windows, and put the 'default' folder in the same directory where the executable is.

Running Gusanos

To run Gusanos, type:

cd bin/posix

If this gives a 'video mode not supported' message from your monitor, look at the FAQ

main/installation_docs/linux.txt · Last modified: 2011/09/18 16:46 (external edit)
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki