Building on Linux

Prerequisites and Dependancies

You will need:

  • The Qt libraries development packages, including Webkit, Network and Script, which sometimes come in different packages.

  • qmake.

  • jsoncpp ( This is packaged as libjsoncpp-dev on Debian.

  • libupnp version 1.6.x (libupnp6-dev). The 1.8 branch is also supported, but there are issues with recent releases. Hopefully, everything should be ok in the future 1.8.5. For now, you are safer with 1.6.x. 1.8.x is ok on recent Fedora releases (because of a different build option).

  • libcurl (libcurl-dev)

  • libexpat (libexpat1-dev)

  • Only for building from git source, and for libupnpp: 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. We used to rely on Fink to do this, but it is now preferable to use the builds. Get Qt from and follow the installation instructions. You just need the base Desktop Qt package.

  2. The above does not include Qt Webkit any more. You can get it from

  3. Build and install the jsconcpp library

    cd [distribution directory]
    mkdir build
    cd build
    cmake -DCMAKE_BUILD_TYPE=release -DBUILD_SHARED_LIBS=ON -G "Unix Makefiles" ..
    sudo make install
  4. Install libupnp. Extract the source code, then:

    cd [distribution directory]
    sudo make install
  5. Install libupnpp. Extract the source code, then:

    cd [distribution directory]
    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
  6. Install Upplay. Extract the source code, then:

    cd [distribution directory]
    /path/to/Qt/5.12.1/clang_64/bin/qmake PREFIX=/usr/local
    sudo make install
  7. Finally, install a link in the usual Applications folder:

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