Building on Linux


You will need:

  • The Qt libraries development packages, including QtWebkit and QtNetwork.

  • qmake.

  • The development packages for libupnp version 1.6 (beware that the package is named libupnp6 on Debian and Ubuntu 14.04, but it was libupnp3 on Ubuntu 12.04), libcurl, and libexpat.

  • Only for building from git source: the autotools (autoconf, automake, libtool).

You need to download the release tar files for libupnpp and upplay, or clone the git repositories: libupnpp, upplay.


Extract the source for libupnpp and upplay, use the following procedures to build the two packages:

Building libupnpp:

cd libupnpp-x.y.z
./configure --prefix=/usr
sudo make install

Building upplay:

cd upplay-x.y.z
sudo make install

And you should now be able to upplay

The above examples are for source extracted from tar release files. For git source, you need to adjust the names of the top directories, and use the following command before the libupnpp configure:


Building on Mac OS X

Thanks to Jacques Distler for providing the procedure:

for libupnpp versions 0.16.0 and earlier and upplay versions 1.2.11 and earlier, you will need to unset libupnpp_la_LDFLAGS in the Makefile before building libupnpp, and add -lupnp to LINK in the upplay Makefile. These should be fixed in later versions.

1) Install QT. Example with Fink as a package manager. To install the relevant QT components:

fink install qt5-mac-qtbase qt5-mac-qtbase-dev-tools qt5-mac-qtwebkit qt5-mac-qtscript

It should be possible to do something similar with MacPorts.

2) Install libupnp. Extract the source code, then:

sudo make install

3) Install libupnpp. Extract the source code, then:

CFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib \
upnp_CFLAGS=-I/usr/local/include upnp_LIBS=-L/usr/local/lib \
./configure --libdir=/usr/local/lib --includedir=/usr/local/include
sudo make install

4) Install Upplay. Extract the source code, then:

/sw/lib/qt5-mac/bin/qmake PREFIX=/usr/local
sudo make install

5) Finally, install a link in the usual Applications folder:

sudo ln -s /usr/local/bin/ /Applications/