gameclock — a simple game clock




This manual page documents briefly the gameclock command.

gameclock is a simple application designed to track the time spent thinking by the players during a chess game. Various ways of tracking time are supported, with only `countdown' (aka `blitz') and `fischer' for now. The graphical interface is keyboard driven and is intended to be minimal and simple. The code is made to be extensible to other game types.


These programs follow the usual GNU command line syntax, with long options starting with two dashes (--). A summary of options is included below.
-h, --help
Show summary of options. This includes the program's version and license.
-v, --verbose
Show progress information to standard output. More `-v' will display more information: timestamps then game state engine.
-f, --fullscreen
Start the application in fullscreen mode.


Most of the interface is keyboard-driven, apart from the initial clock and game configuration.
start the game / end turn
shift keys
end the turn, but only for the appropriate side (left or right side)
pause game
control-r, escape
reset game - this resets all counters and clocks to the initial configuration, use this to restart the game.
toggle the fullscreen mode
quit application


The look of gameclock can be customized fairly easily using GTK resource files. The clock widgets are conveniently named to allow easy customizing. Take for example the sample "Green" builtin theme:

style "clockui" {
  bg[NORMAL] = "black"
  fg[NORMAL] = "white"
  bg[SELECTED] = "red"
  fg[SELECTED] = "black"
  bg[ACTIVE] = "green"
  fg[ACTIVE] = "black"
widget "*.clockui.GtkEventBox" style "clockui"
widget "*.clockui.*Label" style "clockui"


gameclock was written by Antoine Beaupré.