Building The Client

Compiling from Source



This guide will step you through building the looking glass client on Debian based systems from source, before you attempt to do this you should have a basic understanding how to use the shell.

Prerequisites

Before building you will need to install the following packages on your system

  • cmake
  • libsdl2-dev
  • libsdl2-ttf-dev
  • libssl-dev (note: this will be replaced with nettle-dev in A12)
  • libspice-protocol-dev
  • libfontconfig1-dev
  • libx11-dev
  • fonts-freefont-ttf
  • libconfig-dev

This can be done by running the following command (using `sudo` if required):

apt-get install cmake libsdl2-dev libsdl2-ttf-dev libssl-dev libspice-protocol-dev libfontconfig1-dev libx11-dev fonts-freefont-ttf libconfig-dev

If you plan to build the latest bleeding edge version from GitHub, you will also need to install `git`. Please be aware however that the latest version will not be supported and is intended for developers only.

Obtaining the Source

If you are a developer and wish to build the latest bleeding edge version you will already be aware of how to clone a git repository, this guide will not cover this.

Obtain the latest release from https://github.com/gnif/LookingGlass/releases. Download both the Source Code and the looking-glass-host executable for Windows.

Building the Client

Note this will change with A12 as the project has been moved to CMake, please stay tuned

To build the project extract the source code into a directory and run the following commands:

cd client
make

If this was successful you should see the client application in the 'bin' directory, named 'looking-glass-client'.

Support Looking Glass

Looking Glass is written and released open source by Geoffrey McRae.
If you would like to support this work he accepts donations on the following platforms: