gogui man page

gogui — Graphical user interface for Go programs.


gogui [-analyze-commands file] [-auto] [-computer-black | -computer-white | -computer-both | -computer-none] [-command command] [-config file] [-gtpfile filename] [-komi value] [-laf name] [-move n] [-program command] [-register] [-size n] [-time timespec] [-verbose] [file]

gogui -help

gogui -version


GoGui is a graphical interface to programs that play the game of Go and use GTP (Go Text Protocol). This reference describes only the command line arguments for invoking GoGui. A complete HTML documentation is included in the GoGui package.


-analyze-commands file

Use the given file to read analyze command configuration.


Automatically start a new game if the program plays both colors and a game is finished.

-command command

Send GTP command at startup. The argument can contain multiple commands separated by '\n'.


Computer plays Black.


Computer plays both sides.


Computer plays no side.


Computer plays White.

-config file

Read command line options and arguments from the given file.

-gtpfile filename

Send GTP file at startup.


Display help and exit.

-komi value

Set the komi value.

-laf name

Set the Swing look and feel. If this option is not used, GoGui tries to use "system" on Linux and Windows, and "quaqua" on Mac OS/X, but shows no error if the look and feel is not found. If the option is used, the name can be "default" or an empty string for the default look and feel of the Java implementation, a full class name, or one of the following shortcuts:













-move n

Load SGF file given as the main argument until the given move number.

-program command

Go program to attach. The argument is the command line to start the program.


Automatically create an entry in the Program menu if GoGui was invoked with the option -program and no menu item for a program with the given command already exists.

-size n

Set the board size.

-time timespec

Set time limits (basetime[+overtime/moves]). The base time and overtime (byoyomi) can have an optional unit specifier (m or min for minutes; s or sec for seconds; default is minutes).


Print debugging messages. This includes the complete stream of GTP commands. Compared to the GTP shell, this has the additional advantage that the commands and responses are written immediately when they are received and the order of the standard output and standard error stream of the Go engine will more likely be in the correct order.


Print version and exit.

Referenced By


02/10/2017 GoGui 1.4.9 GoGui Reference