SetupGuide

Linux Setup Guide

Gentoo linux

• If you're running Gentoo linux, you're lucky, because an ebuild is already available.
  The best way to install the ebuild in gentoo would be to add an portage overlay and copy the file into the overlay. Now in detail:
  

1. mkdir /usr/local/portage
2. add this line to you /etc/make.conf
   PORTDIR_OVERLAY="/usr/local/portage"
3. download the ebuild you want, for example: taspring-linux-release-ebuild-0.72-r1.tar.bz2
4. mv taspring-linux-release-ebuild-0.72-r1.tar.bz2 /usr/local/portage
5. cd /usr/local/portage
6. tar jxvf taspring-linux-release-ebuild-0.72-r1.tar.bz2
7. most likely you don't run a ~x86 system (unstable) so do a:
   echo "games-strategy/taspring-linux-release ~x86" >> /etc/portage/package.keywords
8. echo "dev-libs/boost threads" >> /etc/portage/package.use
9. You might want to have a look at the USE flags, type:
   emerge -pv taspring-linux-release
10. finally install it with:
    emerge taspring-linux-release

• if you get this error:

Calculating dependencies... done!

>>> Emerging (1 of 1) games-strategy/taspring-linux-release-0.72-r1 to /

>>> checking ebuild checksums ;-)

>>> checking auxfile checksums ;-)

>>> checking miscfile checksums ;-)

>>> checking taspring-linux-data-0.72b1.tar.bz2 ;-)

>>> Unpacking source...

!!! ERROR: games-strategy/taspring-linux-release-0.72-r1 failed.

Call stack:

ebuild.sh, line 1539: Called dyn_unpack

ebuild.sh, line 711: Called src_unpack

taspring-linux-release-0.72-r1.ebuild, line 45: Called subversion_src_unpack

subversion.eclass, line 278: Called subversion_fetch

subversion.eclass, line 127: Called die

!!! subversion.eclass: ESVN_REPO_URI is empty.

!!! If you need support, post the topmost build error, and the call stack if relevant.

!!! This ebuild is from an overlay: '/usr/local/portage'

• Then try: rm -Rf /usr/portage/distfiles/svn-src/spring
• Afterwards do: emerge taspring-linux-release

Debian, Ubuntu & derivatives

• Add one of the following lines to your /etc/apt/sources.list file to enable the repository with spring packages.
  
  deb http://www.osrts.info/~tvo/deb edgy spring # Ubuntu Edgy Eft
deb http://www.osrts.info/~tvo/deb etch spring # Debian Testing
deb http://www.osrts.info/~tvo/deb sid spring  # Debian Unstable


• Update your local package database by running: apt-get update
  (Or use the update feature of your favorite package manager, Synaptic, Adept, aptitude, etc.)

• Install the spring package: apt-get install spring

• Create directories for data files: mkdir -p ~/.spring/{maps,mods,base}

• Point your browser to Unknown Files. Download at least one map from the map section (put it in ~/.spring/maps), and at least one mod from the mod section (put in ~/.spring/mods). The default maps are SmallDivide and Mars. Default mods are either XTA or NanoBlobs (XTA is based on Total Annihilation content, NanoBlobs is free).

• If you downloaded XTA in the previous step, or ever want to play mods that depend on Total Annihilation content (XTA, AA, BA, etc.), then do the following:
  
  wget http://ipxserver.dyndns.org/games/spring/mods/xta/base-ota-content.zip
unzip -d ~/.spring/base base-ota-content.zip
  
  Note that you are legally required to own a copy of Total Annihilation if you perform this last step.

All other linux distributions

• Make sure you have the following packages installed:
  
  build-essential libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev scons subversion zip

• Create a working directory, we'll use this to compile spring:
  
  mkdir ~/workdir
cd ~/workdir

• Download the most recent source tarball (.tar.bz2 file) from BerliOS, save it in ~/workdir.

• Extract the tarball and switch to the directory (adjust version numbers if necessary):
  
  tar xfj spring_0.74b3_src.tar.bz2
cd spring_0.74b3

• Configure: scons configure
  If this doesn't work, be sure to check you installed all dependencies, and peek at the file config.log, which may show the reason it didn't work in detail. To tune the configuration (installation paths, debugging, etc.), refer to: scons -H

• Compile by running: scons
  This can take 5-15 minutes depending on your system.

• To install spring, run the following as root: scons install

• Set up spring to look in your home directory for data files (run as root):
  
  mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir'
  
  Alternatively you can specify it in ~/.springrc (if you don't have root access):
  
  echo "SpringData=$HOME/.spring" >> ~/.springrc

• Now continue at the fourth (4th) step under Debian, Ubuntu & derivatives: "Create directories for data files".

Tips:

• If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.

• Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)
  
  (define devices '(alsa))
(define speaker-num 2)

(define alsa-out-device "hw:0,0")
(define alsa-in-device "hw:0,0")
  
  Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

• If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...

• Just poke any developer on IRC:

• channel #taspring on FreeNode
• or channel #sy on QuakeNet

• Post it on the forum
• or file a bug in our bug tracking system.