Repository navigation
fastchess-gui v0.5.9
A macOS version, opening books that can no longer crash a tournament, and the code now checked automatically for
vulnerabilities.
macOS
- fastchess-gui and the fastchess command line tool now run on macOS 13.3 (Ventura) or newer, Apple silicon and
Intel, as one universal application. The profile is in~/Library/Application Support/fastchess/fastchess-gui/;
CPU affinity, which macOS does not have, is not offered there. Headless:
fastchess-gui.app/Contents/MacOS/fastchess-gui --run …. - The application is not signed by an Apple developer account, so macOS refuses it the first time: Control-click
(right-click) it, choose Open, then Open again. On macOS 15 and later, try to open it once, then go to System
Settings, Privacy & Security, and click Open Anyway. Or, in Terminal, runxattr -dr com.apple.quarantineon the
unzipped folder, which also clears the fastchess tool next to it. Engines you download yourself may need the same. - It is built and its tests run on GitHub's Macs; it has not been tried by a person on a Mac yet. Reports are welcome.
Opening books and test suites
- An opening book could crash a tournament: a PGN game with a comment before its first move, a FEN tag or EPD line
without a king or otherwise malformed, or a malformed castling move. Openings whose position cannot be played are
now left out with a warning (one line per book); on the Books page they count as illegal positions. - An ambiguous move in a PGN book now ends that opening's line instead of rejecting the whole book.
- An EPD test suite, an opening book under inspection, a PGN book turned into an engine's own book, or a WinBoard
engine's move can no longer crash the program with such positions or moves; they are skipped or flagged as
illegal.
Safety
- A tournament folder received from someone else can no longer make the program write outside it: the file every
game is also appended to must be a.pgnfile (older tournaments with another name open with a warning and no
longer append there), and a folder whose journal, PGN files or lock file are symbolic links is not opened for
writing. - Files the program creates are not writable by other users whatever the umask, and
settings.jsonis readable by
its owner only from the moment it holds a lichess token. - The code, the vendored fastchess included, is now checked automatically: CodeQL on every change, Coverity Scan
every week, the tests under AddressSanitizer and UndefinedBehaviorSanitizer, the dependencies against known
vulnerabilities (OSV-Scanner, from a list of every dependency insbom/fastchess-gui.cdx.json), and fuzzers
feeding malformed web requests, tunnel server text, TLCS datagrams, PGN and EPD files and engine output to the
program.
Broadcast tunnel
- The tunnel's memory stays bounded whatever its viewers send: it reads every viewer's connection on every pass,
waiting ones included, and a viewer sending a flood of tiny packets, or all of them sending at once while your
connection is saturated, no longer ends the session; such a viewer is let go alone. Viewers beyond its capacity
(40 relayed, 40 waiting, 40 queued by the SSH library) are refused at once. - The bundled libssh2 is modified for this (see
cmake/patch_libssh2.cmake): a viewer's connection holds at most
128 KiB, and a channel's small packets are kept as bytes rather than a block of memory each. - The tunnel no longer leaves its SSH session (its memory and keys) behind when a connection ends while the server
has stopped reading, and its goodbye reaches the server though a packet was left half sent.
Engines
- On macOS and Linux, an engine started by a wrapper script is ended with the script when a check or a game is
interrupted.
Downloads
| File | Contents |
|---|---|
fastchess-gui-v0.5.9-linux-x86_64.tar.gz |
fastchess-gui and the fastchess command line tool, x86-64 Linux (glibc 2.35 or newer). Needs X11 or Wayland and OpenGL 3.2. |
fastchess-gui-v0.5.9-windows-x86_64.zip |
fastchess-gui.exe and fastchess.exe, 64-bit Windows 10 version 1903 or newer. No installer, nothing else to install. |
fastchess-gui-v0.5.9-macos-universal.zip |
fastchess-gui.app and the fastchess command line tool, macOS 13.3 or newer, Apple silicon and Intel. Not signed: see above for the first launch. |
SHA256SUMS.txt |
Checksums of the three archives. |
The binaries are built by this repository's GitHub Actions workflow; the tests run on Linux, Windows and macOS. The
archives carry the licenses of the libraries built in (see ATTRIBUTION.md).
Known limitations
They are tracked as issues labelled known limitation.