Nocheto Help

This is the list of all nocheto commands. See also commands for setup mode.
Commands tagged with [s] are stoppable commands. They can be stopped by stop command.

To show help for commands in nocheto version 2, use help command or extrahelp command.

Help

Commands:

new [<level>]

start a new game at level <level> (0-20)

new960 [<id>]^1.1.0

start a new Chess960 game with a random position
or a position given by the <id> (0-959)

[move] [<x>]

do move <x> (i.e. d7d5 or e7e8q or e8Q etc.),
or go to the next move if any
You can use -- fro a null move^2.2.0

moves [<moves> [*]]^2.1.0

add moves in the branch at the current position
i.e. moves 1.e4 (1.c4 c5) e5 2. Nf3 *
If the moves are not added as the argument,
they are expected to be written on next lines and ended by *.

play, p

[s^2.4.0] ask nocheto to move

play to end

[s] ask nocheto to play the rest of the game

play <eng> vs <eng>^2.0.0

[s] let play two engines against each other
First <eng> will play as the white.

play vs <eng>^2.0.0

[s^2.4.0] set <eng> as the engine used by play command
(Note: new/new960 commands reset engines to the
main one.)

undo [<n>], u

undo halfmove n-times (default 1)

uu

undo all moves

up

undo before first variants in the current branch

up<

undo to the beginning of the current branch

up<<

undo back to the main branch

redo [<n>], r

redo halfmove n-times (default 1)

r<

redo halfmove, stay on the current branch

r>[> ...]

redo halfmove, go to the first [second ...] branch

replay [<s>], rr

[s] redo all moves, wait <s> second every move
(default 1)

goto <move>, g

go to <move>, where <move> is a move number

cut^2.4.0

cut everything before the current move

delete

delete current move (with the rest of the branch)

promote

move the current branch up in the moves tree

loadresults, lr

load results from a database into the current game

hint [<seconds>]

[s^2.4.0] hint a move for the current position

analyze[!], a[!]

analyze the current move
If ! is used, save the result to a database
(can take 2x more time)

analyze+[!], a+[!]

[s] analyze all moves in the current branch
from the current move forward
If !, save result to a database
(takes 2x more time)

nags^2.1.0

show the table of all supported annotations (renamed to listnags in 2.2.0)

listnags^2.2.0

show the table of all supported annotations

nag [<nag>]

add annotation glyphs (i.e. !, !?, +/- etc.)
to a current move.
If no nag is set, all nags from the current move
are removed

setnag [<nag>]^2.2.0

replace annotation glyphs (i.e. !, !?, +/- etc.)
If no nag is set, all nags from the current move
are removed

comment, cmt [<cmt>]

add comment after the current move

bcomment, bcmt [<cmt>]

add comment before the current move

level [<level>]

set or show engine level (0-20) (default 0)

seconds [<seconds>], s

set or show seconds engine can think (default 6)

setoption <eng> <opt> [val]^2.3.0

set value of option <opt> for engine <eng>
<eng> = engine name
<eng> = * for all but main engine
<eng> = - for main engine

engines^2.2.0

list all configured engines

autoplay, ap

switch "automatic computer move" (default true)

autoboard, abo

switch "show board after move" (default true)

board, b [<boardtype>^2.2.0]

change the board to <boardtype> and redraw it

listboards^2.3.0

list all available board types

listthemes [board|pieces]

list themes you can use with boardtheme and
piecestheme commands

boardtheme <theme>

set the theme for a graphics board (kitty board)

piecestheme <theme>

set the theme for pieces on a graphics board

boardwhitecolor <r,g,b>

set red, green and blue color components
for the white fields on a graphics board
(i.e. boardwhitecolor 255,255,255)
(both boardwhitecolor and boardblackcolor must be
set to take effect)

boardblackcolor <r,g,b>

set red, green and blue color components
for the black fields on a graphics board

clearboardcolors

clear boardwhitecolor and boardblackcolor
the boardtheme takes effect then

movecolor <r,g,b>^2.3.0

set red, green and blue color components for
a stroke around the current move in a graphics
board

flipboard, fb

flip the board

viewboard, vb

enable drawing board

viewcoordinates, vc

switch drawing the board coordinates

viewcpmeter, vcp

switch drawing of the cpmeter

viewevaluation, veval^2.3.0

show/hide evaluation colors in the cpmeter,
moves trees and in variants.

vweval^2.3.0

show/hide evaluation for white moves

vbeval^2.3.0

show/hide evaluation for black moves

viewgraph, vg

enable/disable drawing of the result graph

viewtree, vt

enable/disable drawing the moves tree

viewtreeheight [<n>]^2.5.0

set or show the maximum height of the moves tree
(use 0 for unlimited height)

expandtree, et

switch expanding of the moves tree

viewmoves, vm

enable/disable drawing of all possible moves

viewvariants, vv

enable/disable drawing next moves in the game

viewopening, vo

enable/disable drawing of the opening name

viewexplorer, ve

enable/disable moves explorer view

viewexplorerheight [<n>]^2.5.0

set the maximum height of the moves explorer
(0 for unlimited)

viewgamesexplorer, vge^2.3.0

enable/disable games explorer view

viewtablebase, vtb

enable/disable the tablebase
(works for 7 and less pieces)
(require internet access to tablebase.lichess.ovh)

viewfen, vf

enable drawing of the FEN

keepontop^2.0.0

switch clearing of the console before drawing

switchsounds^2.0.0

enable/disable sounds

namespaces <name(s)>^1.1.0

set namespace names for the game explorer
you can use * for 'all namespaces'
the default namespace is primary

setup

enable setup board mode

fen <fen>

start a new game with a <fen> position

fen960 <fen>^1.1.0

start a new Chess960 game with a <fen> position

pgn

read game(s) from PGN written to stdin

tags

list PGN tags of the current game

tag <name> [<value>]

set tag <name> to <value>. If no <value> is given,
tag is removed
(<name> is case sensitive!)

printpgn [<file>], pp

print PGN of the current game to a console
or to the <file>

printpgn! [<file>], pp!^2.0.0

the same as printpgn,
but rewrite the <file> if exists

explore [id ...^2.2.0]

create a list from games from explorer,
with the current position or for a given id(s)
(enable viewgamesexplorer to see game id(s))

explore+ [id ...]

as explore, but games are added to the existing list

search^2.2.0

search games in the explorer database

search<^2.2.0

search games in the explorer database with
the current position
search [b|w]p="Euwe" vs="Capablanca" >50 1922(-1938) 1-0

list [[<limit>] <from>]

show list of games

open <file>

open PGN file

open /\<n>

open game id <n> from PGN file (see list command)

mergelist <file, ...>^2.4.0

create a new sheet from all games from all file(s)

mergelist+ <file, ...>^2.4.0

as mergelist, but adds games to the current sheet

merge <file, ...>^2.4.0

create a new game as combination of all lines from
all games from all given PGN files

merge+ <file, ...>^2.4.0

as merge, but adds lines to the current game

puzzle [<filename>]

Enable puzzle mode (for games from file <filename>)

save [<file>]

save PGN to opened file (if any) or <file>
Set <file> as opened file.

save! [<file>]^1.1.1

the same as save, but rewrite existing <file>

ipv4 [<port>]

[s] open connection on 127.0.0.1:<port>
(default 8001)

ipv4 <port> <address>

[s] open connection on <address>:<port>
(default 127.0.0.1:8001)

http <port> <address>^2.4.0

start http server on <address>:<port>
(default 0.0.0.0:8080)
This is an experimental feature. Run nocheto with --future option to get it.
See also Nocheto HTTP API.

listhttp^2.6.0

list running HTTP servers

news [id]

show last unreaded news if any or the
news with ID <id>

listnews [offset]

show last news' titles with theirs id and date

help, h

show help

extrahelp

show help for extra commands

info, i

show info

owner

show licence / owner details

checkforupdate

check for update

quit

quit nocheto

Extra commands:

speach

switch text to speech
Removed in 2.7.0

speech^2.7.2

switch text to speech

addnamespace <name> [<descr>]^1.1.0

create namespace in a database
(used by nochetodbload)
Name can consists of english lowercase letters
and numbers only
the default namespace is primary

dropnamespace <name>^1.1.0

drop empty namespace from a database

listnamespaces^1.1.0

list namespaces

stop^2.0.0

stop running stoppable command

stoplist^2.0.0

list stoppable commands

echo <text>

print the <text> (and read it if speach is on)

d

show engine board (if supported)

eval

get the engine evaluation (if supported)