Skip to content
FabriceFABS edited this page Mar 13, 2022 · 23 revisions

Table of Contents

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":http://developer.apple.com/opensource/tools/index.html, if you haven't already.

Also, in order to install the various dependencies of the project (see below), we recommend you to install the latest version of MacPorts (www.macports.org), which is a package repository system (somewhat similar to debian's apt-get). See also MacOS and http://springrts.com/phpbb/viewtopic.php?f=65&t=23455

Windows

Windows does not have the necessary tools preinstalled, you need to get "MinGW and MSYS":http://www.mingw.org/ (the simplest option) or "Cygwin":http://www.cygwin.com/.

Software Dependencies

Required

The following packages are *required* to compile SpringLobby.

  • wxWidgets >=2.9.0
  • a c++ compiler like g++
  • GNU Make
  • CMake
  • boost (thread, system, filesystem)
  • libcurl (linux packages *libcurl3* & *libcurl4-dev* (as of summer 2014))
  • libpng (linux packages *libpng12-0* & *libpng12-dev* (as of summer 2014))
  • alure (no more required if sound disabled with: -DOPTION_SOUND=OFF)

Optional

The following software, while not required for a functional SpringLobby build, allow additional features. Most people will want to have these installed.

  • libopenal
  • gettext
  • doxygen
  • boost (test)
  • glib (linux packages *libglib2.0-bin* & *libglib2.0-dev* (as of summer 2014))
  • minizip
  • openssl

Specific OS commands

Debian 10

This will probably also work for Ubuntu and other Debian-based systems:

sudo apt install build-essential cmake libwxgtk3.0-dev libssl-dev libboost-thread-dev libboost-system-dev libboost-filesystem-dev libcurl4-openssl-dev libpng-dev libalure-dev

Fedora 20

yum install gcc-c++ cmake boost-devel wxGTK-devel libcurl-devel libnotify-devel alure-devel openssl-devel

Gentoo

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

Check the currently used version:

eselect wxwidgets list

Linux Mint 20.3

This will work for Linux Mint and maybe other Debian-based systems:

apt install build-essential cmake libwxgtk3.1-gtk3-dev libssl-dev libboost-thread-dev libboost-system-dev libboost-filesystem-dev libcurl4-openssl-dev libpng-dev libalure-dev

Windows

git clone -b "alure-1.x" git://repo.or.cz/alure.git alure-1.x

Download Source Tarball

Download the latest tarball: http://springlobby.info/

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) gettext or the openAL libs, you can disable with:

cmake . -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 --recursive https://github.com/springlobby/springlobby.git
cd springlobby
cmake .
make
make install

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

cmake -DOPTION_SOUND=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 bug report send a patch. Remember to attach full log of the command that failed, and from configure also. If not sure then contact developers.

Clone this wiki locally