GoGui Installation Notes

Basics

GoGui requires at least Java version 5. The recommended Java runtime environment is Oracle's Java SE 7 or a new version of OpenJDK (it might work on older versions of OpenJDK but there can be minor rendering issues, e.g. the stones on the board are not completely round).

GoGui comes with precompiled Java jar files for GoGui and the GTP tools in the lib directory. GoGui does not necessarily need to be installed on the system, it can be run from the directory where the distribution file was extracted to.

For Unix systems there are launcher scripts in the bin directory. The launcher scripts respect the environment variable GOGUI_JAVA_HOME, if defined, and look for the jar files relative to the bin directory.

Installation on Linux

For Linux, there is an installation script install.sh, which installs GoGui into the system directories and integrates it into the desktop environment. This script needs to be run as root. It has options to specify the location of the java runtime (-j, default is /usr), the installation directory (-p, default is /usr/local) and sysconf directory (-s, default is etc relative to the installation directory).

On newer Linux systems with a recent version of OpenJDK, you probably do not have to change the default parameters and you can simply run

sudo ./install.sh.

Installation on Windows

A Windows installer is available from GoGui's project page.

Installation on Mac OS

A Mac application bundle can be created by compiling GoGui from the sources (see below) and running

ant gogui.app.

Compiling from the Sources