Guide: Installing from Source

Introduction

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

Tools

OS X

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

Windows

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

Software Dependencies

Required

The following packages are required to compile SpringLobby.
  • wxWidgets >=2.8.0
  • a c++ compiler like g++
  • GNU Make
  • CMake
  • pkg-config

Optional

The following software, while not required for a functional SpringLobby build, allow additional features. Most people will want to have these installed.
  • libopenal
  • libcurl
  • gettext
  • libtorrent-rasterbar >= 0.13. Required for Download Manager. Note that most Linux distributions supply a package named libtorrent: this is not the same libtorrent! You can download libtorrent-rasterbar from http://www.rasterbar.com/products/libtorrent/.

Download Source Tarball

Download the latest tarball: gzip or bzip2

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

Configuring, Compiling and Installing

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

cmake . -DOPTION_TORRENT_SYSTEM=OFF -DOPTION_TRANSLATION_SUPPORT=OFF -DOPTION_SOUND=OFF 

otherwise use:

cmake .

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

Building from Git

git clone git://springlobby.info/git/buildbot/springlobby.git
cd springlobby
cmake .
make
make install

If you would like to disable sound and torrents, replace cmake command above with:

cmake -DOPTION_SOUND=OFF -DOPTION_TORRENT_SYSTEM=OFF .

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 [/newticket?type=bug bug report] or [/newticket 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

Fedora 12 users need:

yum install gcc-c++ cmake wxGTK-devel SDL_mixer-devel SDL_sound-devel rb_libtorrent-devel

New file

Also available in: HTML TXT