Skip to main content

Configuration

Chess-tui can be configured through the configuration file located at ~/.config/chess-tui/config.toml. This section covers all available configuration options.

Command Line Options​

Some configuration options can also be set directly from the command line:

# Set chess engine path
chess-tui -e /path/to/engine

# Set bot thinking depth
chess-tui --depth 15

# Combine both options
chess-tui -e /path/to/engine --depth 15

Command line options take precedence over configuration file values.

Configuration File​

The configuration file is automatically created when you first run chess-tui. You can modify it manually to customize your experience:

# ~/.config/chess-tui/config.toml

# Display mode: "DEFAULT" or "ASCII"
display_mode = "DEFAULT"

# Chess engine path (optional)
engine_path = "/path/to/your/engine"

# Logging level: "OFF", "ERROR", "WARN", "INFO", "DEBUG", or "TRACE"
log_level = "OFF"

# Bot thinking depth for chess engine (1-255, default: 10)
bot_depth = 10