en cs

Nocheto command line options

This page describes nocheto command line options.

Help

Use --help to show the command line options help.

$ nocheto --help
Nocheto (Noidea Chess Tool) 3.2.0:2002M, Ubuntu20_04, author: Petr Bílek (nocheto.sallyx.org)
USAGE: nocheto [-h|--help] [-o|--owner] [-d|--debug] [-c|--config <file.ini>]  [-e|--engine <engine>] [-b|--board <boardtype>] [--ipv4] [-l|--merge-list|-m|--merge] [--ignore-pgn-error] [ -- <file.pgn>]
        file.ini    - Read configuration from this file (after reading nocheto.ini and engines.ini)
        engine      - name of engine section from config files or executable name
                      (default stockfish)
        boardtype   - Board GUI (default (iso), default-utf8 (utf8), ascii, ascii-utf8, compressed, compressed-utf8, kitty)
                      (default utf8)
        file.pgn    - load PGN game from this file

$ nocheto --help
Nocheto (Noidea Chess Tool) 2.7.1.1928M, Ubuntu19_10, author: Petr Bílek (nocheto.sallyx.org)
USAGE: nocheto [-h|--help] [-o|--owner] [-d|--debug] [-c|--config <file.ini>]  [-e|--engine <engine>] [-b|--board <boardtype>] [--ipv4] [-l|--merge-list|-m|--merge] [ -- <file.pgn>]
        file.ini    - Read configuration from this file (after reading nocheto.ini)
        engine      - name of engine section from config files or executable name
                      (default /home/petr/bin/stockfish_17/stockfish)
        boardtype   - Board GUI (iso, utf8, ascii, ascii-utf8, compressed, compressed-utf8, kitty, kitty-utf8)
                      (default utf8)
        file.pgn    - load PGN game from this file

Debug

Use --debug to debug nocheto communication with engine and other internal communication. This is for developing purposes only, you probably wouldn't need it.

Config

Use --config filename.ini to read configuration file.

Nocheto always reads ~/.nocheto/configs/nocheto.ini file first and then the file required by --config option. So you can use this file to change only a few configuration options. Values read from the first config file are replaced by values read from the second one (if they are defined there).

The filename can be absolute path (i.e. ~/.nocheto/configs/tweak.ini) or just the base name (i.e. tweak.ini) in which case the full path is assembled from ~/.nocheto/configs/ and this name.

Board type

Use --board boardtype to select the desired board design. Available board types are: iso, utf8 (the default), ascii, ascii-utf8^2.4.0, compressed, compressed-utf8^1.1.0, kitty^2.0.0 and kitty-utf8^2.1.0.

ISO board (iso)

ISO board is usefull on terminals without utf8 support
(i.e. on terminals where you get by CTRL+ALT+F2).

UTF8 board (utf8)

This board uses UTF8 characters to show chess pieces, annotations etc.

Compressed board (compressed)

This board shows minimum information, is very compact and doesn't use any UTF-8 characters.

Compressed UTF8 board^1.1.0 (compressed-utf8)

The same like compressed board, but uses UTF-8 characters.

ASCII art board (ascii)

This board uses ASCII art to show chess pieces. It is usefull on big terminals with many rows and colums (i.e. on terminals where you get by CTRL+ALT+F2). It doesn't use any UTF-8 characters.

ASCII UTF8 art board^2.4.0 (ascii-utf8)

This board uses asci ASCII for pieces, but some ohter output uses UtF-8 characters.

Kitty board^2.0.0

This board can be used on kitty console only.
It is possible to change graphics of the board or pieces. (See help gui).

Kitty utf8 board^2.1.0

As kitty, but some information can be shown using UTF-8 characters.

Chess engine

Use --engine engine to change chess engine used for play and analyze games. It is recomended to use this option over setting engine in configuration file. Keep the configuration value on stockfish (or whatever you consider the strongest engine).

You can use configuration files to set the default chess engine. Stockfish is the recomended.

You can also use the name of an engine section (without the engine_ prefix) from engie configuration section.^2.3.0

Wait for a nocheto client (nochetoclient)

Use --ipv4 to start waiting for nochetoclient. This behaves the same way as if you run ipv4 command in nocheto just after it starts.

How to open PGN file

To open PGN file, just write its name after nocheto (and all its options).
This opens the file the same way as if you run open filename.pgn command in nocheto.

Merge list

Use --merge-list file(s) to create sheet from all games located in all the given PGN files.

Merge games

Use --merge file(s) to create one game as a combination of all games in the given PGN files.

Ignore malformed PGN file^3.2.0

If you start nocheto with a PGN file(s) as an argument or use --merge or other argument with a PGN file and one of the given files is corrupted (or doesn't exists etc.), nocheto prints an error message and ends.
Use --ignore-pgn-error to let nocheto to continue the start as if there were no error.

Owner^2.1.0

Use --owner to show the owner's credentials.