Description of sections, properties and theirs values in the nocheto configuration files

checkforupdate

checkforupdate = 1

Download news from https://nocheto.sallyx.org/ at the start of nocheto and also checks for a new version of nocheto.

This might freeze nocheto when executed if the page or your internet connection is down. In that case set this value to 0.

checkdayinterval

checkdayinterval = 1

How many days between checks for update.

Properties names in this section are irelevant, they just need to be unique.

Example

[startup]
cmd1="http silent"

Example above has one property cmd1 which runs http silent command whenever nocheto starts (works with the --future option only).

More commands can be separated by semicolon in one property.

The difference between more commands separated by a semicolon and more commands addeded as a separate property is that in the second case asynchronous (stopable) commands "eat" all following commands (they will not be run).
If you separate commands by semicolon in one property, they are called one by one after the previous command ends even if the command is stopable.

pngclock^3.0.0

pgnclock = ""

Sets what time related commands are used in PGN outputs.

Possible values:

• empty (do not print any)
• clk prints clk commands

logfile^2.4.0

logfile = ""

Path to a file where UCI communication will be logged. (See also --logfile option.)

engine

engine = stockfish

Path to the UCI engine used by nocheto. You can change this value by command line option --engine. Use nocheng value for nochetoengi!

If the path is not absolute, the engine executable is searched in the paths in your $PATH variable.

level

level = 0

The strength of the engine. 0 = weakest, 20 = strongest.
Level is used for playing moves only. Move analzye always runs at the highest level (20).

goseconds

goseconds = 1

The maximum number of seconds engine things about a move. It is also used in nochetoclient in the analyze mode to set the time of thinking about one move^2.0.0. Set it to -1 for infinite time thinking in nochetoclient in the client.ini config file.

By using ! after the numeric value you set this value to all configured engines^2.4.0.

threads

threads = 1

Number of threads (processor units) the engine should use.

autoplay

autoplay = 1

Use 1 or 0 to enable / disable autoplay. (Autoplay means that whenever you make a move, nocheto ask engine to also make a move.)

multipv^1.1.0

multipv = 1

Set the maximum count of lines client will show in the analyze mode.

boardtype

boardtype=utf8

Value could be one of iso, utf8, ascii, ascii-utf82.4.0, compressed, compressed-utf81.1.0, kitty2.0.0 and kitty-utf82.1.0.
See nocheto option --board.

autoboard

autoboard = 1

Whether or not to rewrite the bard automatically.

If autoboard is set to 0 (usefull for blindfold chess), you can always show the board by using board (b) command.

viewgraph

viewgraph = 0

Enable/disable the moves' evaluation graph.

viewtree

viewtree = 1

Enable/disable the moves tree.

viewtreeheight

viewtreeheight = -1

The maximum count of rows the moves tree shoud take. Value -1 means unlimited.

viewtabletree^3.0.0

viewtabletree = 0

Enable/disable the moves table three.

viewtabletreeheight^3.0.0

viewtabletreeheight = 0

The maximum count of rows the moves table tree tree shoud take. Value 0 means `maximum is the same as the board height`, -1 means unlimited.

viewboard

viewboard = 1

Enable/disable chess board view.

viewmoves

viewmoves = 0

Enable/disable showing all possible moves in the current position.

viewvariants

viewvariants = 0

Enable/disable showing the following moves from the moves tree.

colorvariants

colorvariants = 1

Enable/disable colors in the move variants.

viewfen

viewfen = 0

Enable/disable showing the current position's FEN.

viewopening

viewopening = 0

Enable/disable showing opening name of the current position.

viewcpmeter^3.1.0

viewcpmeter = 1

Enable/disable centipawns meter.

viewcoordinates

viewcoordinates = 1

Enable/disable coordinates of the chess board.

viewexplorer

viewexplorer = 0

Enable/disable explorer.

viewexplorerheight^2.5.0

viewexplorerheight = 0

Limits height of the explorer. Value 0 means unlimited.

viewgamesexplorer^3.0.0

viewgamesexplorer = 0

Enable/disable game explorer.

gamesexplorerdimension^3.0.0

gamesexplorerdimension = 2 0

Set the numer of colums (default 2) and rows (default 0) of games in the explorer.
Value 0 for rows means `same as the board height`, -1 means unlimited.

See also vgedimension command.

gamesexplorermode^3.0.0

gamesexplorermode = "both"

The mode can by "asc" (show oldest games), "desc" (show newest games) or "both" (show both newest and oldest games).

See also vgemode command.

viewtablebase

viewtablebase = 0

Enable/disable tablebase (require internet access to tablebase.lichess.ovh).

viewcomments

viewcomments = "window,tree"

Enable/disable displaying comments.

expandtree

expandtree = 0

Enable/disable moves tree expansion.

Example of not expanded vs expanded:

expandtabletree^3.0.0

expandtabletree = 0

Eanble/disable table tree view expansion.

actualmove_l

actualmove_l = ">>"

Characters on the left side of the current move in the moves tree.

actualmove_r

actualmove_r = "<<"

Characters on the right side of the current move in the moves tree.

actualmove_color

actualmove_color = 44

Color of the current move in the moves tree. See [console].

currenttablemove_l^3.1.0

currenttablemove_l = "*"

Characters indicating white move in the moves table tree.

currenttablemove_r^3.1.0

currenttablemove_r = "* "

Characters indicating black move in the moves table tree.

analyzenotation

analyzenotation = "algebraic"

What kind of notation to use for best lines (in nochetoclient analyze mode).

Possible values are algebraic (i.e. Nf3) or german (i.e. g1f3).
Unknown value is interpreted as german.

whiteisofield^2.3.0

whiteisofield="."

Character used to fill empty white field in the iso boards.

blackisofield^2.3.0

blackisofield=""

Character used to fill empty black field in the iso boards.

whiteutf8field^2.3.0

whiteutf8field="."

Character used to fill empty white field in the utf8 boards.
If not set, value of whiteisofield is used.

blackutf8field^2.3.0

blackutf8field="."

Character used to fill empty black field in the utf8 boards.
If not set, value of blackisofield is used.

stalemateisosign^2.4.0

stalemateisosign="#="

Characters used to mark stalemate in a moves tree in the iso boards.

stalemateutf8sign^2.4.0

stalemateutf8sign="#="

Characters used to mark stalemate in a moves tree in the utf8 boards.
If not set, value of stalemateisosign is used.

Colors used for console pieces, current move or chess board could be:

speach

speach = 0

Enable/disable text to speach.

The text to speach function needs installed and configured espak application (it is part of most linux distributions).

playsounds^1.1.0

playsounds = 1

Enable/disable sounds.

You need to have installed and configured aplay application (it is part of most linux distributions).

keepontop^2.0.0

keepontop = 0

Clear the console before drawing the board. It means that the board will be always drawed from the top row of the console.

whitecolor

whitecolor = 93

Color of the white pieces on the console boards.

blackcolor

blackcolor = 31

Color of the black pieces on the console boards.

boardcolor

boardcolor = 34

Color of the console boards.

movecolor

movecolor = 33

Color used to emphasize the starting and landing chess board fields of the last played move.

onmovecolor^2.0.0

onmovecolor = 34

Color of the star marking the player on move (the star is in top right or bottom right corner of the board - depending on who is on move).

bestmovecolor^2.0.0

bestmovecolor = 92

Color used for moves evaluated as the best.

okmovecolor^2.0.0

okmovecolor = "37!"

Color used for moves evaluated as OK (not the best but not inaccurancy also).

inaccuracymovecolor^2.0.0

inaccuracymovecolor = "35"

Color used for moves evaluated as inaccuracy.

mistakemovecolor^2.0.0

mistakemovecolor = 33

Color used for moves evaluated as mistake.

blundermovecolor^2.0.0

blundermovecolor = "31!"

Color used for moves evaluated as blunder.

bestlinecolor^2.0.0

bestlinecolor = "90!"

Color used for the lines of best moves.

whitefieldcolor^2.3.0

whitefieldcolor = ""

Color used for character filling empty white board field. See whiteisofield.

blackfieldcolor^2.3.0

blackfieldcolor = ""

Color used for character filling empty black board field. See blackisofield.

boardtheme^2.0.0

boardtheme = "default"

Where to search for board image. Images must be in the nepix format and saved in ~/.nocheto/themes/<theme>/board.nepix or /usr/local/share/nocheto/themes/<theme>/board.nepix file.

Alternatively, you can use board.txt file to set board colors by a text file.^2.3.0

For example, if you create ~/.nocheto/themes/poisonous/board.txt with this content: 10,255,10 0,33,0 255,255,0, kitty board with boardtheme="poisonous" will look like this:

piecestheme^2.0.0

piecestheme = "default"

As boardtheme, but for pieces images. If not set, it uses the boardtheme value.

boardwhitecolor^2.0.0

boardwhitecolor = ""

Color for white squares of the kitty board. The value must be 3 numers (red, green and blue value of the color) between 0 and 255 separated by comma (example: boardwhitecolor = "255,255,255").

boardblackcolor^2.0.0

boardblackcolor = ""

Color for black squares of the console board. The value must be 3 numers (red, green and blue value of the color) between 0 and 255 and separated by comma (example: boardblackcolor = "0,0,0").

movecolor^2.3.0

movecolor = "155,0,0"

Color used for stroke around the last move on the kitty board.

Property name is the name of the timecontrol value used by the setclock command.

Value is the timecontrol. See Timecontrols documentation to understand these values.

Example

[timecontrols]
default="180+1"
classical="40/7200:900+30"
standard="40/7200:3600"
rapid="900+10"
rapid30="1800"
blitz="300+5"
blitz5="300"
blitz3="180"
bullet="60"
bullet2="120+1"
hourglass="*180"

There are some aliases predefined in the default nocheto.ini file. For example, c = O-O means that you can use c command to castle king side (cc = O-O-O is defined for castling to the queen side).

There is a restriction on characters used in the properties' names in the INI file (for example the property name can't start with exclamation mark !). Such property names have to be inside alias[] like this: alias[!] = "nag !". (This define ! alias that executes nag ! command.)

Using underscores in the alias names is deprecated^3.1.1 and will be not allowed in the future versions^4.0.0.

You can even rewrite an existing command by alias. For example, redo = "r<" causes redo (which is also called by the key ENTER) to always go in the main line of the moves tree (the default behavior of redo is going through the last (alternative) line you were in).

See the [alias] section in the default nocheto.ini.

player

player = 

Player name (a name used in the PGN tag White or Black).

dbname

dbname = data/explorer/

Directory where to save (sqlite) database data.

You need to have the read/write access to this directory.

namespaces^1.1.0

namespaces = primary

Namespace(s) used by explorer from which are selected games. You can use * for all existsing namespaces.

You can configure the same properties as under the [database] section.

If no [explorer] section is configured, game/move explorer use configuration from the [database] section. So you can use one database for both the moves' evaluation and explorer.