Welcome to chess.el, a client and library for playing Chess from Emacs.

chess.el is an Emacs Lisp library and several clients on top of the underlying library functionality for performing various activities related to the game of chess.

You can play against an external chess program such as gnuchess, crafty, phalanx or sjeng. All of them are publically available, and chess.el will automatically detect which one you have installed, provided they have standard executable program names, and are in a located in a directory which is part of the PATH. See the customisable variable `chess-default-engine'.

You can also play against another human or computer over the internet (through a direct Emacs-to-Emacs connection, or on one of the Internet Chess Servers like freechess.org or chessclub.com), or even against a very simple chess thinking module implemented in pure Emacs Lisp.

chess.el also provides a mode for editing Portable Game Notation (PGN) files.

To improve your chessaility, you might also like to have a look at chess-puzzle, which allows you to solve chess puzzle collections (in PGN or EPD format) against one of the engines you have installed.

These days, chess.el is maintained as part of GNU ELPA, the Emacs Lisp Package Repository. Use `M-x list-packages RET' to show information about, and install, the current version.