thomas-mauran/chess-tui

Play chess in any terminal. Rust TUI, Stockfish, Lichess.

Rust

1,198

255 commits

updated Oct 10, 2026

thomas-mauran.github.io/chess-tui

See the code

See what people are saying

Newest first

Most points

Source	Message	Score	Date
	chess analysis as TUI (r/commandline) Hello guys, I did a small chess TUI for analyzing games, largely inspired by common analyses UX. This is not entirely new, most gain here is convenience. It is made solely for analysis. You can start an analysis from a FEN string, PGN file, PGN text from your clipboard, public link from…	5	Oct 9, 2026

README

chess-tui

Chess in the terminal. Free, cross-platform terminal chess game in Rust. Local play, Stockfish, Lichess. 🦀

Chess TUI: terminal chess board with piece selection

Description · Quick Install · Features · Quick Start · Controls · Documentation · Platforms · FAQ · Contributing

Description

chess-tui is a free, open-source terminal chess game. Play with a friend locally, against any UCI chess engine (e.g. Stockfish), or online via Lichess. Runs on macOS, Linux, and Windows.

Quick Install

Homebrew:

brew install thomas-mauran/tap/chess-tui
chess-tui

Cargo:

cargo install chess-tui
chess-tui

Debian/Ubuntu:

DEB_URL=$(curl -s "https://api.github.com/repos/thomas-mauran/chess-tui/releases/latest" | jq -r '.assets[] | select(.name | endswith(".deb")) | .browser_download_url') && curl -LO "$DEB_URL" && sudo dpkg -i "$(basename "$DEB_URL")" && sudo apt-get install -f
chess-tui

Available on:

For installation via package managers or other methods, see the Installation Guide.

Features

Local 2 player mode

Chess TUI local two-player mode in terminal

Play against any UCI chess engine

Playing against UCI chess engine (e.g. Stockfish) in terminal

Lichess Integration

Play online on Lichess directly from your terminal!

See Lichess Features for details.

Online multiplayer

Helper menu

Custom skins

Quick Start

Connect a chess engine:

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

# Engine with command-line arguments (e.g., GNU Chess with UCI mode)
chess-tui -e "/opt/homebrew/bin/gnuchess --uci"

# Stockfish example
chess-tui -e /opt/homebrew/bin/stockfish

See Bot Configuration for details.

Configure Lichess:

chess-tui -l YOUR_LICHESS_TOKEN_HERE

See Lichess Setup for details.

Other options: --depth 15 (engine depth), --difficulty easy|medium|hard|magnus, --no-sound. See Configuration for all flags and config file.

Controls

Key	Action
Arrow keys or h/j/k/l	Move cursor
Space	Select piece / move
Esc	Deselect or close popup
?	Help menu
s	Cycle skins
b	Back to menu
q	Quit

Press ? in-game for the full list.

Documentation

📚 Full Documentation (installation, configuration, Lichess, multiplayer).

Installation (Cargo, Homebrew, Debian/Ubuntu, Arch, NixOS, Docker, binary)
Configuration (config file, skins, bot, logging)
Lichess (seek game, join by code, ongoing games, puzzles)
Multiplayer (LAN and over the internet, e.g. with bore)

Platforms

Platform	Install
macOS	`brew install thomas-mauran/tap/chess-tui` or `cargo install chess-tui`
Linux	`cargo install chess-tui`, .deb, or binary
Arch	`pacman -S chess-tui`
NixOS	`nix-shell -p chess-tui` or install from nixpkgs
Windows	`cargo install chess-tui`

FAQ

Does it work with Stockfish? Yes. Run chess-tui -e /path/to/stockfish (see Bot Configuration).
Can I play on Lichess from the terminal? Yes. Get a Lichess API token and run chess-tui -l YOUR_TOKEN.
What is chess-tui built with? Rust, ratatui (TUI), shakmaty (chess), ruci (UCI engine support).
Where is the config? config.toml and skins.json in your config dir (e.g. ~/.config/chess-tui/ on Linux). See Configuration.

Troubleshooting

Run into issues? Check the docs: Lichess setup & troubleshooting, Bot configuration & troubleshooting. Otherwise open an issue.

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

Project health

crates.io

chess_tui

Latest release

2.7.1 · May 21, 2026

Releases this year

Significant stargazers

Bartosz Kaszubowski

469 followers · starred Aug 2026

Thibault Duplessis

6,499 followers · starred Jan 2026

tranzystorekk

111 followers · starred Dec 2023

Axel H.

288 followers · starred Dec 2025

Similar repos

leolaurindo/chess-analyzer-tui

A lightweight chess.com-style analyzer. Runs with any UCI engine. Read games from your favorite…

franciscoBSalgueiro/en-croissant

The Ultimate Chess Toolkit

1,935

maaslalani/gambit

Play chess in your terminal

904

DarkCenobyte/scacelith-chess

Free and open-source photorealistic 3D chess game with Stockfish 19, a voice coach, online…

lichess-bot-devs/lichess-bot

A bridge between Lichess bots and chess engines

1,096

AmethystineAlpaca/camera_chess

Play chess with Local AI on a physical chessboard using a camera. Local board recognition and…

lemunozm/ruscii

Terminal graphics engine: build your games in the terminal!

211

orangishcat/cursed-tetris

cursed terminal tetris (rust learning experience)

thomas-mauran/chess-tui

Play chess in any terminal. Rust TUI, Stockfish, Lichess.

Rust

1,198

255 commits

updated Oct 10, 2026

thomas-mauran.github.io/chess-tui

See the code

See what people are saying

Newest first

Most points

Source	Message	Score	Date
	chess analysis as TUI (r/commandline) Hello guys, I did a small chess TUI for analyzing games, largely inspired by common analyses UX. This is not entirely new, most gain here is convenience. It is made solely for analysis. You can start an analysis from a FEN string, PGN file, PGN text from your clipboard, public link from…	5	Oct 9, 2026

README

chess-tui

Chess in the terminal. Free, cross-platform terminal chess game in Rust. Local play, Stockfish, Lichess. 🦀

Chess TUI: terminal chess board with piece selection

Description · Quick Install · Features · Quick Start · Controls · Documentation · Platforms · FAQ · Contributing

Description

Quick Install

Homebrew:

brew install thomas-mauran/tap/chess-tui
chess-tui

Cargo:

cargo install chess-tui
chess-tui

Debian/Ubuntu:

DEB_URL=$(curl -s "https://api.github.com/repos/thomas-mauran/chess-tui/releases/latest" | jq -r '.assets[] | select(.name | endswith(".deb")) | .browser_download_url') && curl -LO "$DEB_URL" && sudo dpkg -i "$(basename "$DEB_URL")" && sudo apt-get install -f
chess-tui

Available on:

For installation via package managers or other methods, see the Installation Guide.

Features

Local 2 player mode

Play against any UCI chess engine

Lichess Integration

Play online on Lichess directly from your terminal!

See Lichess Features for details.

Online multiplayer

Helper menu

Custom skins

Quick Start

Connect a chess engine:

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

# Engine with command-line arguments (e.g., GNU Chess with UCI mode)
chess-tui -e "/opt/homebrew/bin/gnuchess --uci"

# Stockfish example
chess-tui -e /opt/homebrew/bin/stockfish

See Bot Configuration for details.

Configure Lichess:

chess-tui -l YOUR_LICHESS_TOKEN_HERE

See Lichess Setup for details.

Other options: --depth 15 (engine depth), --difficulty easy|medium|hard|magnus, --no-sound. See Configuration for all flags and config file.

Controls

Key	Action
Arrow keys or h/j/k/l	Move cursor
Space	Select piece / move
Esc	Deselect or close popup
?	Help menu
s	Cycle skins
b	Back to menu
q	Quit

Press ? in-game for the full list.

Documentation

📚 Full Documentation (installation, configuration, Lichess, multiplayer).

Installation (Cargo, Homebrew, Debian/Ubuntu, Arch, NixOS, Docker, binary)
Configuration (config file, skins, bot, logging)
Lichess (seek game, join by code, ongoing games, puzzles)
Multiplayer (LAN and over the internet, e.g. with bore)

Platforms

Platform	Install
macOS	`brew install thomas-mauran/tap/chess-tui` or `cargo install chess-tui`
Linux	`cargo install chess-tui`, .deb, or binary
Arch	`pacman -S chess-tui`
NixOS	`nix-shell -p chess-tui` or install from nixpkgs
Windows	`cargo install chess-tui`

FAQ

Does it work with Stockfish? Yes. Run chess-tui -e /path/to/stockfish (see Bot Configuration).
Can I play on Lichess from the terminal? Yes. Get a Lichess API token and run chess-tui -l YOUR_TOKEN.
What is chess-tui built with? Rust, ratatui (TUI), shakmaty (chess), ruci (UCI engine support).
Where is the config? config.toml and skins.json in your config dir (e.g. ~/.config/chess-tui/ on Linux). See Configuration.

Troubleshooting

Run into issues? Check the docs: Lichess setup & troubleshooting, Bot configuration & troubleshooting. Otherwise open an issue.

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

Project health

crates.io

chess_tui

Latest release

2.7.1 · May 21, 2026

Releases this year

Significant stargazers

Bartosz Kaszubowski

469 followers · starred Aug 2026

Thibault Duplessis

6,499 followers · starred Jan 2026

tranzystorekk

111 followers · starred Dec 2023

Axel H.

288 followers · starred Dec 2025

Similar repos

leolaurindo/chess-analyzer-tui

A lightweight chess.com-style analyzer. Runs with any UCI engine. Read games from your favorite…

franciscoBSalgueiro/en-croissant

The Ultimate Chess Toolkit

1,935

maaslalani/gambit

Play chess in your terminal

904

DarkCenobyte/scacelith-chess

Free and open-source photorealistic 3D chess game with Stockfish 19, a voice coach, online…

lichess-bot-devs/lichess-bot

A bridge between Lichess bots and chess engines

1,096

AmethystineAlpaca/camera_chess

Play chess with Local AI on a physical chessboard using a camera. Local board recognition and…

lemunozm/ruscii

Terminal graphics engine: build your games in the terminal!

211

orangishcat/cursed-tetris

cursed terminal tetris (rust learning experience)

thomas-mauran/chess-tui

See what people are saying

README

chess-tui

Table of contents

Description

Quick Install

Features

Quick Start

Controls

Documentation

Platforms

FAQ

Troubleshooting

Contributing

Links

Project health

Significant stargazers

Similar repos

thomas-mauran/chess-tui

See what people are saying

README

chess-tui

Table of contents

Description

Quick Install

Features

Quick Start

Controls

Documentation

Platforms

FAQ

Troubleshooting

Contributing

Links

Project health

Significant stargazers

Similar repos