Chapter 4. Main Window

Table of Contents

Go Board
Info Panel
File Menu
Game Menu
Edit Menu
Go Menu
Shell Menu
Bookmarks Menu
Settings Menu
Help Menu

Go Board

Clicking on an empty field in the Go board plays a move there. In setup mode, score mode or after certain analyze commands, clicking on a field has a special meaning (see Setup Mode, Score, and Chapter 7, Analyze Commands).

If Show Cursor is enabled in the Settings menu, then fields can be selected with the keyboard by moving the cursor (the red square corners) with the cursor keys to the target field and pressing Enter. Holding Shift while pressing a cursor key moves the cursor to the next handicap line in this direction or to the edge of the board.

Info Panel

The panel on the right side of the board shows information about the current position, for example the last move and the variation number. A text field exists for displaying and editing comment text for the current position. If you select text in the comment field, it will automatically parsed for valid points, which will be marked on the board while the text is selected. Selected text in the comment is also used as a default text for Find in Comments.

File Menu

Open

Open a game from a file in SGF format.

Note

Only a subset of the SGF definition is supported. Most notably game collections and certain kind of setup positions are not supported. The current GTP standard does not define a setup command. Setup stones are always translated to play commands for the Go program, which is problematic, if the setup stones lead to a Go position that contains blocks with no liberties. Currently, no check for this situation is performed, even if it causes the Go program to capture the blocks and therefore be out-of-sync with the game tree. Delete points are sent as play empty commands to the Go program, which should respond with an error, because play empty is not valid according to the GTP standard. Unknown SGF properties are preserved, if the game is saved to a file again.

Open Recent

Open a game from a list of recently used files.

Save

Save the current game to the associated filename. If the game has no filename, this menu item acts like Save As.

Save As

Save the current game to a file. If the file name ending is sgf, the game is saved in SGF format. If the file name ending is tex, the game is exported to LaTeX using PSGO style.

Export / SGF Position

Export the current position to a file in SGF format.

Export / LaTeX Main Variation

Export the main variation of the current game to a LaTeX file using PSGO style.

Export / LaTeX Position

Export the current position to a LaTeX file using PSGO style. Some board markups are also exported (string labels, marked and selected points).

Export / Text Position

Export the current position to a text file.

Print

Print a screen shot of the current board position, including all markups from analyze commands.

Attach Program

Attach a Go program to the current game at the current position.

Detach Program

Detach currently attached Go program from game and terminate the Go program.

Quit

Quit GoGui.

Game Menu

New Game

Start a new game.

Computer Color

Choose what side the Go program plays.

Play

Change the computer color to the color to move and make the computer start playing.

Play Single Move

Make the computer play a move, but do not change the computer color.

Interrupt

Interrupt the command that is currently running. This menu item is only active if a lengthy command (like move generation) is running and if the Go program supports interrupting (see Chapter 9, Interrupting Commands).

Clock

Halt or resume the clock. If time settings were used, the remaining time for the players is stored in the tree nodes and can be restored with the Restore item.

Pass

Make a pass move.

Cleanup

Generate cleanup moves. Cleanup moves are moves played after the game has ended with two passes in a row. They should not pass before all dead stones are captured. This item is only enabled, if the program supports the kgs-genmove_cleanup or genmove_cleanup command. It will be automatically set after two pass moves have been played.

Score

Score the current game. A window will be opened containing score information. First the Go program will be asked what stones are dead with the final_status_list dead command. Dead stones are marked with a cross-hair. If the Go program does not support this command, or you don't agree with it, you can change the status of stones by clicking on them. You leave score mode by closing the score window.

Edit Menu

Find in Comments

Find next game node containing a search pattern. The search is case insensitive. The pattern is a regular expression as used by the Java java.util.regex.Pattern class, similar to Perl syntax.

Find Next

Find next game node containing the last entered search pattern.

Game Info

Edit the game information. Changes to the komi and rules are transmitted to the Go program. The only supported rules are "Chinese" and "Japanese". The program is informed about the komi and the rules with GTP commands, if supported (see Chapter 3, Compatibility).

Size

Change the board size and start a new game.

Handicap

Set the number of handicap stones.

Make Main Variation

Make the current variation to the main variation.

Delete Side Variation

Delete all variations except for the main variation.

Keep Only Position

Delete all variations and create a new game tree with the current position as setup stones.

Truncate

Truncate the current variation beginning at and including the current node.

Truncate Children

Truncate all children variations of the current node.

Setup Mode

Enter or leave setup mode. In setup mode you can place or remove stones of the current color. The current color can be changed with the Black and White menu item from the Setup menu. It is also possible to place stones of the other than current color, without switching the color, by pressing a modifier key while placing a stone (Ctrl, Alt or Meta) or using the right mouse button.

Note

Setting up a position is not reversible. After leaving setup mode, you are in a new game starting with the current position and the current color to move.

Setup Black

Set the current color for setting up stones and the color to move to Black.

Setup White

Set the current color for setting up stones and the color to move to White.

Go Menu

Beginning

Go to beginning of game.

Backward 10

Go backward 10 moves.

Backward

Go backward one move.

Forward

Go forward one move.

Forward 10

Go forward 10 moves.

End

Go to end of the current variation.

Go to Move

Go to a certain move number in the current variation.

Next Variation

Go to the next variation.

Previous Variation

Go to the previous variation.

Next Earlier Variation

Go to the next variation earlier in the game tree.

Previous Earlier Variation

Go to the previous variation earlier in the game tree.

Back to Main Variation

Go back to the main variation.

Go to Variation

Go to the start node of a certain variation.

Shell Menu

Save Log

Save the GTP streams to a log file.

Save Commands

Save the sent GTP commands to a file.

Send File

Send GTP commands from a file to the engine.

Send Recent

Send GTP commands from a recently opened file to the engine.

Bookmarks Menu

Add Bookmark

Add a new bookmark.

Edit Bookmarks

Edit bookmarks.

Settings Menu

Show Toolbar

Show toolbar.

Show Info Panel

Show panel on the right side of the board containing game information.

Show Tree

Show the game tree window.

Show Shell

Show the GTP shell window.

Show Analyze

Show the Analyze window.

Configure Board / Show Cursor

Show cursor on board for keyboard navigation. Fields can be selected on with the Enter key.

Configure Board / Show Grid

Show grid.

Configure Board / Show Last Move

Mark the last move with a red circle.

Configure Board / Show Variations

Mark the moves of all variations from this position with letters starting with 'A' ('+' will be used after 'Z'). If multiple variations start with the same move, a '.' is appended.

Configure Board / Beep After Move

Beep after each computer move. With most versions of Java the PC speaker is used for the beep.

Configure Board / Fixed Size Comment Font

Use fixed-width font for comment.

Configure Tree / Labels

Configure the labels on the tree nodes.

Configure Tree / Size

Configure the size of the tree nodes.

Configure Tree / Show Subtree Sizes

Show the number of nodes in the subtree for nodes that are not expanded.

Configure Shell / Popup Completions

Popup a window with command completions while entering a command.

Configure Shell / Auto Number

Automatically number GTP commands. Note that some Go programs don't comply to the GTP standard by not supporting GTP commands with a numerical ID. They will usually answer with "Unknown command", because they try to parse the ID as a command.

Configure Shell / Timestamp

Prepend each sent or received line with a time stamp.

Configure Analyze / Only Supported Commands

Only show commands supported by the current Go engine.

Configure Analyze / Sort Alphabetically

Sort command labels alphabetically. Otherwise the analyze command list has the same order as in the configuration files.

Configure Analyze / Reload Configuration

Reload configuration files defining the commands after they were edited.

Help Menu

GoGui Documentation

Open a window for browsing the GoGui documentation.

About

Show the version of GoGui and the Go program (if there is a program attached).