mdoege / fbuci

An UCI chessboard for the Linux framebuffer

fbUCI, an UCI chess frontend for the Linux framebuffer

The default engine is /usr/bin/stockfish, but other UCI engine binaries can also be used.

Prerequisites

Needs python-chess and Pillow

Framebuffer screen size is set to 1920x1080, so on Raspbian be sure to disable overscan in /boot/config.txt.

On some Linux distros other than Raspbian you may need to add yourself to the video group for permission to use the framebuffer.

Usage

Enter moves in UCI notation, e.g. e2e4, e1g1 (castling kingside), or a7a8q (pawn promotion to Queen).

You will play as White by default; to play as Black just add black as a commandline parameter.

Hit enter to redraw the board; enter r to rotate board; enter q to quit.

License

GPL

Board and piece images are from Lichess.

fbuci's Issues

board display

at last i managed to run your code .. i'm on Linux (Xubuntu 22.04) and i struggled with the 'framebuffer' /dev/fb0 .. it was not accessable .. it seems the command python3 ./fbuci.py must be executed as root, otherwise /dev/fb0 is unaccessable .. so i ran sudo python3 ./fbuci.py in an environment (which is recommended) an i get this output :

Your move? e2e4
  1. e4      c5
Your move? d2d4
  2. d4      cxd4
Your move? c2c3
  3. c3      dxc3
Your move? q
Goodbye!
(fb-env) roelof@roelof-HP-Elite-x2-1012-G2:~/Apps/fbUCI$ 

it seems stockfish is playing (i had to change the path to /usr/games/stockfish) but no board is displayed like your screenshot .. am i missing something or is this only a terminal application ?