README.md

chess-tui

A chess TUI implementation in rust 🦀

Demo

With docker

docker run --rm -it ghcr.io/thomas-mauran/chess-tui:main

With Cargo

cargo install chess-tui
chess-tui

With Github

git clone git@github.com:thomas-mauran/chess-tui.git
cd chess-tui
cargo build --release
./target/release/chess-tui

NetBSD

On NetBSD a pre-compiled binary is available from the official repositories. To install it, simply run:

pkgin install chess-tui

Arch Linux

You can install from official repositories:

pacman -S chess-tui

Features

Helper menu

Local 2 player mode

Draws

• Stalemate
• 50 moves rules
• 3 time repetition of the same position

Piece Promotion

no demo available yet

Play against any UCI chess engine as black or white

Play the white pieces

Play the black pieces

Connect a chess engine

You can play chess-tui with any UCI compatible chess engines. To do so you will need to use the -e command to give the chess engine binary path.

Example:

chess-tui -e /your/bin/path

Here I installed stockfish using homebrew and gave chess-tui the path the the engine binary. This command will store in your home directory the chess engine path so you don't have to relink it everytime !

Roadmap

You can find the roadmap of the project here if you want to contribute.

Crates.io

The project is also available on crates.io here