Configuration files readed by nocheto executables are in INI format in the
This page describes the file format and properties you can change by it.
First time you run nocheto it makes a copy of
~/.nocheto/configs/nocheto.ini file. This file is readed by nocheto executables, but you
can usally use
--config filename option to read another ini file.
Many values in this config file are default values used in nocheto and can by changed "on the fly" by nocheto commands. But changes made by this commands are not stored anywhere aftrer nocheto ends. If you wish to make the changes permanent, you must change the ini file.
Description of INI format
INI file is ordinary text file, which has special format. It is divided into
several sections, which starts by its name in [square brackets]. On the rows below it
you can set values to different variables in format
variable = value,
where value can be "string in quotes" (or without quotes if there is no white space in value),
or number. For boolean values (which can be true or false)
0 is used for false/no and
1 for true/yes.
# to the end of line is a just a comment (it is ignored).
Default nocheto.ini file looks like this:
[nocheto] checkforupdate = 1 [engine] engine = stockfish level = 0 goseconds = 1 threads = 1 autoplay = 1 multipv = 11.1.0 [board] boardtype=utf8 autoboard = 1 viewgraph = 0 viewtree = 1 viewtreeheight = -1 viewboard = 1 viewmoves = 0 viewvariants = 0 viewfen = 0 viewopening = 0 viewcoordinates = 1 viewexplorer = 0 viewtablebase = 0 #require internet access to tablebase.lichess.ovh expandtree = 0 actualmove_l = >> actualmove_r = << actualmove_color = 44 [console] speach = 0 playsounds = 11.1.0 whitecolor = 93 blackcolor = 31 boardcolor = 34 movecolor = 33 [aliases] c = O-O cc = O-O-O 0-0 = O-O 0-0-0 = O-O-O ? = "nag ?" ?? = "nag ??" alias[!] = "nag !" alias[!!] = "nag !!" alias[!?] = "nag !?" alias[?!] = "nag ?!" 1 = "r>" 2 = "r>>" 3 = "r>>>" 4 = "r>>>>" 5 = "r>>>>>" 6 = "r>>>>>>"1.1.0 7 = "r>>>>>>>"1.1.0 8 = "r>>>>>>>>"1.1.0 9 = "r>>>>>>>>>"1.1.0 listns = listnamespace1.1.0 [explorer] player = dbname = data/explorer/ namespaces = primary1.1.0
Example of configuration for blindfold chess
~/.nocheto/configs/blind.ini file with this content:
[engine] engine = nocheto goseconds = 1 level = 0 autoplay = 1 [board] boardtype=utf8 autoboard = 0 viewgraph = 0 viewtree = 1 viewboard = 1 viewmoves = 0 viewvariants = 0 viewfen = 0 viewopening = 0 viewcoordinates = 1 viewexplorer = 0 [console] speach = 1
nocheto -c blind.ini to use this configuration.
Sections and values in nocheto.ini
Values in this section are related to nocheto executable.
checkforupdate = 1
Download news from https://nocheto.sallyx.org/ 1x a day. This might freeze nocheto at start if the page or your internet connection is down. In that case, turn this value to 0.
Values in this sections are related to chess engine used for playing in nocheto, or evaluating positions in nocheto, nochetodbeval or nochetoclient in analyze mode.
engine = stockfish
This value is the UCI engine used by nocheto applications. You can change
this value by command line option
--engine. Use nocheng
level = 0
This value sets the strength of the engine. 0 = weakest, 20 = strongest. Level is used for playing the game. Analyzing moves always runs at level 20.
goseconds = 1
The number of seconds engine thing about a move.
threads = 1
Number of threads the engine should use.
Not every engine actually uses this value, but stockfish does.
autoplay = 1
Use 1 or 0 to enable / disable autoplay. (Autoplay means that whenever you do a move, nocheto ask engine to do another move.)
multipv = 1
Set the count of best lines client in analyze mode shows.
Not every engine actually uses this value, but stockfish does.
This sections is about chess board in console configuration. You can change colors or what parts of the board will be shown.
Keep in mind, that not all variables affects all board types.
Could be one of
See nocheto option --board.
autoboard = 1
Whether or not to show automatically bard. By "board" is meant not only chess board, but also moves tree, graph etc.
If autoboard is set to 0 (usefull for blindfold chess), you can always show
board by using
viewgraph = 0
Show the graph.
viewtree = 1
Show moves tree.
viewtreeheight = -1
Maximum count of rows tree shoud take. -1 means unlimited.
viewboard = 1
Whether to show chess board.
viewmoves = 0
Whether to show all possible moves.
viewvariants = 0
Whether to shows following moves from moves tree.
viewfen = 0
Whether to show FEN of current position.
viewopening = 0
Whether to show opening name.
viewcoordinates = 1
Whether to show coordinates around chess board.
viewexplorer = 0
Whether to show explorer.
viewtablebase = 0
Whether to show tablebase (require internet access to tablebase.lichess.ovh).
expandtree = 0
Whether to expand moves tree.
actualmove_l = >>
Characters on the left side of actual move in moves tree.
actualmove_r = <<
Characters on the right side of actual move in moves tree.
actualmove_color = 44
Color of actual move in moves tree.
Colors used for console pieces, actual move or chess board could be:
- Default console color
- Light Gray
- Dark Gray
- Light Red
- Light Green
- Light Yellow
- Light Blue
- Light Magenta/Pink
- Light Cyan
speach = 0
Enable/disable text to speach. You need to have installed espak application (its part of most linux packages systems).
playsounds = 1
whitecolor = 93
White pieces color for console boards.
blackcolor = 31
Black pieces color for console board.
boardcolor = 34
Board color of console board.
movecolor = 33
Color used to emphasize starting and landing chess board cells for last move was played.
You can use this section to add new names to nocheto commands.
There are some aliases predefined. For example,
c = O-O means that you can use
c command to
castle king side.
There is a restriction on variable name characters (for example variable
can't start with
!), so sometime you have to put the variable
alias. For example,
alias[!] = "nag !" means,
that you can use
! command to add ! annotation
to an actual move.
You can even change meaning of an existing command by it. For example,
redo = "r<" causes
redo command (which is also
called by ENTER) to always go in the main line of the moves tree
(the default behavior is going through the last alternative line you were
Player name (for example your nickname you use to play online).
dbname = data/explorer/
Directory where to save (sqlite) database data. You need to have writte access to this directory.
namespaces = primary
Namespace(s) used by explorer from which are selected games. You
* for all existsing namespaces.