Which Installation Method to Use

If there is a prebuilt/prepackaged option below for your system, use that.

If not, get a tarball to install from source.

Developers and packagers go to our hacking page for repository access, then continue on to compiling source.

Prebuilt or Prepackaged

Windows Binary

• Installing for first time

Download the latest binary.

Download the dlls.

Extract both zip files into same folder.

• Upgrading existing install

Download the latest binary

If your existing install is older than 0.10224, download the dlls

Extract zip file(s) into same folder where you have your existing install, overwriting files of old install.

Your user settings, which are stored separately, will not be overwritten.

Gentoo

• Install

We have a portage overlay, so installation is very convenient. The same overlay contains spring itself too. Maps, mods and lua scripts will come in the future.

If you don't have layman installed:

emerge layman
echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf

When layman is installed:

layman -f -a Spring -o 'http://svn.springlobby.info/trunk/gentoo/overlays.xml'
echo "games-strategy/spring ~x86" >> /etc/portage/package.keywords
echo "games-util/springlobby ~x86" >> /etc/portage/package.keywords
echo "x11-libs/wxGTK X" >> /etc/portage/package.use
emerge spring springlobby

If layman or portage overlays are new to you, go see http://overlays.gentoo.org/.

• Upgrade

layman -S
emerge -u spring springlobby

Slackware 12

• Install or Upgrade

A fancy .tgz is ready to install at linuxpackages there and have a small dependency on wxWidgets, againd available on linuxpackages right there.

In order to install springlobby as a Slackware tgz, open a console in the same directory of the packages and do the following:

installpkg springlobby-0.0.1.10219-i486-1leo.tgz wxwidgets-2.8.7-i486-1gds.tgz

The order does not matter. And then, a nice icon will appear in the games section of your desktop menu. If you appreciate performance, springlobby is the name of the executable, located in /usr/bin, add it on you preferred window manager menu.

if you want to build from source, a sample SlackBuild can be found (and enhanced) here

Debian

• Install

There is no .deb for debian, but Ubuntu .deb can be used, if you follow these instructions exactly.

First add Yokozar's repository to your sources (you don't need this if you installed spring the same way):

sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \
-O /etc/apt/sources.list.d/springproject.list

Now you must build and install the lobby package:

sudo apt-get update
sudo apt-get build-dep spring-lobby-springlobby -y
apt-get --build source spring-lobby-springlobby -y
sudo dpkg -i spring-lobby-springlobby_*.deb

Note the * in the last command. This is because the filename depends on the version you built.

• Upgrade

You don't need to add the repository anymore, but you must repeat the steps for building and installing the package, as shown above.

Ubuntu

• Install:

sudo wget http://ppa.launchpad.net/spring/ubuntu/sources.list.d/gutsy.list \
    -O /etc/apt/sources.list.d/springproject.list

sudo apt-get update
sudo apt-get install spring-lobby-springlobby

• Upgrade

sudo apt-get update
sudo apt-get upgrade

openSuse, Suse Linux, Fedora and Mandriva

(acc)Agon provides nearly the latest automated release as rpm packages from openSuse build service.
Available package types: src, binary and debug
Supported distributions / architectures :

Distribution	i586	x86_64	binary	source	debug
openSuse factory	-	-	-	-	-
openSuse 10.3	x	x	x	x	x
openSuse 10.2	x	x	x	x	x
Suse Linux 10.1	x	x	x	x	x
Suse Linux 10.0	x	x	x	x	x
Suse Linux Enterprise 10.0	x	x	x	x	x
Fedora 8	-	-	-	-	-
Fedora 7	x	x	x	x	x
Fedora Extras 6	x	x	x	x	x
Mandriva 2007	-	-	-	-	-
Mandriva 2006	x	-	x	x	x

home:accAgon

• How to add a repository to yast (openSuse / Suse Linux): http://en.opensuse.org/Add_Packages_Repositories_to_YaST
• How to install a package in yast (openSuse / Suse Linux): http://en.opensuse.org/YaST_Software_Management

You need superuser privileges to install it.

Mandriva

to add repositories, follow the instructions on easy urpmi

then this simple command will install the lobby:

su root -c "urpmi springlobby"

ArchLinux

springlobby is available as Package in the Arch User Repository (AUR): http://aur.archlinux.org/packages.php?do_Details=1&ID=12486
Check http://wiki.archlinux.org/index.php/AUR_User_Guidelines on how to use AUR.

Installing from Source

These instructions should work on linux and other unixes, including OS X. They will even work on windows, if you download some tools.

OS X might not have any developer tools preinstalled, but you can get Xcode Tools from Apple, if you haven't already.

Windows does not have the necessary tools preinstalled, you need to get MinGW and MSYS (the simplest option) or Cygwin.

Download Source Tarball

Download the latest from our file archive. Get a .bz2 unless you really know that you need a .gz package.

After downloading, unpack the file and cd to the unpacked directory.

The following example assumes bash, wget, bzip2 and a random version number of the tarball. You at least have to check the correct version number to use it. You can of course just download it with your browser instead.

cd /tmp
VERSION=0.0.0500 # this of course depends on what is current at the time
wget http://www.springlobby.info/tarballs/springlobby-${VERSION}.tar.bz2
tar xjf springlobby-${VERSION}.tar.bz2
cd springlobby-${VERSION}/

Configuring, Compiling and Installing

You need to have the following software to do this:

wxWidgets >=2.6.3 (>=2.8.0 gives extra functionality)
g++
gnu make

The following libraries are totoally optional, but will extend the functionality

libSDL >= 1.2.0
libSDL_sound
libSDL_mixer
libtorrent-restarbar >= 0.13 (note that most distros pack another library which shares the name, but is a different thing. Make sure it's the one from http://www.rasterbar.com/products/libtorrent/

Configure, then compile; if you don't have (or don't want to install) libtorrent or the SDL libs, you can disable the integrated downloader and sound respectively with:

./configure --disable-torrent-system --disable-sound

otherwise use:

./configure

to start compiling (might take a couple of minutes):

make

The following command installs the program. It needs root / admin / super user rights, so do what is necessary on your platform to have them.

make install

Troubleshooting

If building the latest source doesn't work, take a look at buildbot status page and if there's a lot of red on the top of the page, the developers already know that the build is broken. If not, then you are welcome to submit a bug report or send a patch. Remember to attach full log of the command that failed, and from configure also. If not sure then contact developers.

Note on Dependencies

Debian (and probably ubuntu) users can get the dependencies with:

sudo apt-get install build-essential automake libwxgtk2.8-dev

Gentoo users need:

echo 'x11-libs/wxGTK X' >> /etc/portage/package.use
emerge \>=x11-libs/wxGTK-2.8.0

Check the currently used version:

eselect wxwidgets list

User-Specific Configuration

SpringLobby needs to know three paths from your spring installation.

Auto Configure feature in the lobby options page should find all of them.

Debian package for 0.74b3 is broken and does not contain unitsync.so at all! You should not be using old versions of spring, see spring setup guide for instructions on upgrading.

If you are out of luck, please contact developers.