Repository navigation
fastchess-gui v0.6.0
Several tournaments at once that keep playing when the window closes, on this computer or on others over SSH, a
home page that shows what runs and what needs you, a new tournament page built on profiles and the engine library,
a Board page to analyse, open, paste and play, long runs that no longer stop for one engine, and the guide built into
the program, in every language of the interface.
Several tournaments at once
- Tournaments play side by side, each in a process of its own, and share the machine: a budget of cores in
Settings (the physical cores less one by default), split by a weight on each tournament's card, none above its
own concurrency. A smaller share never interrupts a game. A tournament alone plays as before. - They keep playing when the window closes (Keep them running and quit, the default), and the window shows them
again at its next launch. A crash takes down one tournament, not the others nor the window. - The workspace has a tab per open tournament; the Log shows the lines of one tournament, of the window, or all.
- A memory budget (three quarters of the memory installed by default): a game starts only when its two engines'
Hashand processes fit; the summary says how many games it allows at once, and the home page when games wait
for memory. - Engines that use a GPU are marked in the library, with the number of GPUs in Settings: no more of them play at
once than there are GPUs, within and across tournaments. - Engine checks, quick tests, test suites and the Board page no longer wait for the end of a tournament.
- Headless:
--run FOLDER|SETUP.json --detachplays a tournament in the background,--attach FOLDERtalks with
it, and the window shows it when it opens.
Remote machines
- Settings > Machines: other computers reached over SSH (an SSH agent or a key file, Ed25519 or RSA, its passphrase
asked and never written), each with its folder and its own budget of cores and memory. Test the connection tells
its system, threads, memory, free disk and the fastchess-gui installed there; Install / Update copies this
program there when the system matches, or a release you choose. Windows machines work through their built-in
OpenSSH server (see the guide). - Each engine of the library gets a path on each machine, checked there (present, can be run, answers). An engine
missing there is copied by Copy…, alone or with its folder (its network files), after a check that it is built
for the machine's system and processor (or Choose the Linux build…, remembered for that machine); a SHA-256
tells whether the build there is this computer's, with Replace with this computer's. The opening books and the
Syzygy files the tournament uses are compared with the machine's, and the missing ones are copied there in the
background, verified after. - Run on in the setup plays a tournament on a machine: started there in the background, followed from the window
as a local one, connected again after a network cut, its games and logs copied back as they come. The home page
card says which machine.
Home page
- What runs comes first: a bar of the cores in use (and of memory and GPUs once budgeted), split by tournament and
the Board page; a card for each running tournament with its progress, when it ends, its leader and Elo (or the
LLR of an SPRT), Open, Pause and its weight. - Needs action, first: an engine that cannot start, a tournament stopped by an error, a drive too full for a
night of games, each with its fix in place. - The queue with when everything ends, the last finished tournaments with their result and Relaunch with…, and
Pause all / Resume all.
Unattended runs
- An engine that cannot start no longer stops the tournament: after its tries its games are set aside, the others
go on, it is tried again every 5 minutes (or at once with Try again) and its games come back once it starts. The
header and the home page say which engine and why, with its engine log, Withdraw… and Replace…. The tournament
stops only when nothing is left to play without it. Stop the tournament when an engine cannot start brings back
the old behaviour. - Messages name the engine, the resource and the fix, with a button for it: a program or a folder not found
(Open the engine, Locate…), an engine with too many threads, its own default included (Lower Threads), an
option value an engine refuses, the engine that crashed, the log (Open the log). - The Syzygy tablebases the tournament uses (the adjudication's folders and each engine's
SyzygyPath) are checked
before the start: missing or damaged files, and adjudication beyond the pieces found, with Open the folder and
Lower to 5 pieces. - The Health card tells the incidents by engine, and the losses on time in the first moves apart: more often an
engine set up wrong than its time management. - A rebuilt engine program is noticed with what changed: its name, option defaults changed, options new or gone,
with Keep my values or Use the new defaults for each option or all. The setup warns before a tournament with
an engine rebuilt since its last one, and a resumed tournament says so in its header, with Continue or Pause.
New tournament
- Profiles for each section: Format (with the SPRT bounds), Time control, Openings, Adjudication and Engine
settings, each a row with its profile, a one-line summary and its details opened in place. A change for this
tournament only is marked, with Save as profile, Update the profile and Revert. Presets come with it (common
time controls such as 10+0.1, 60+0.6, 40 moves in 15 minutes, a standard adjudication). - Templates name a profile for each section, plus what no profile holds; old templates and setups load as before.
- The engine library beside the participants: filter by name, group or notes, group chips, sort by reference Elo,
marks for engines with a problem; double-click, Enter or drag adds, Ctrl and Shift select several, drag reorders.
The participants keep the width for their names; a participant's own Hash, Threads, nodes, time odds and book
are in its ⋯ menu. - Help moved into tooltips, with the words other programs use (games per encounter, opening suite, rounds); the
concurrency says which rule chose the number of games at once. - A team match: two teams of engines, everyone against everyone or board by board, scored by team (points, score,
Elo) and by engine, with a team crosstable, in the copies, the PGN tags and the broadcast. - SPRT: an Elo bias on both bounds, and a minimum number of games before a decision.
- Polyglot books: a randomness from the best move only to every move alike, the weights as they are by default,
for the tournament's book and the engines' own books. - Unbalanced openings flagged as the games end (both engines beyond a score for their first moves after the book):
a filter in Games, a count in Openings and on the overview, their pairs played again from another opening if
asked, and left out of Export as EPD….
Board page
- A new page: an engine of the library analyses any position, several lines drawn as arrows, with its own threads,
hash and lines that never reach a tournament. A on any board (a live game, a finished one, an opening, a book)
opens its position there. - Open any PGN file (its games filtered by their tags), paste a FEN, a PGN or a list of moves, set up a position.
- Analyse a finished game move by move: its inaccuracies, mistakes and blunders marked, a curve of the analysis.
- Play a game, or a pair, between two engines from the position on the board, beside a running tournament.
- An engine console, from the engine card: type commands to an engine and read its answers.
Games and boards
- Set a game's result by hand (draw, 1-0 or 0-1, with a reason), with its impact shown first and Undo; the PGN
files stay as they were, the result and aTerminationtag applied when the games are read and exported. A game
in progress can be ended with a result too, except on macOS for now. - Buttons under every board that shows a game (first, previous, next, last, flip); a live game can be stepped back
while it goes on, with Back to the current move. They can be hidden in Settings. - A big screen mode for a television or a stream: one game filling the window, large names and clocks, the
evaluation bar, the last move marked, F11 for full screen; it can switch between games or follow the most
interesting one. - Board colours (presets, or your own for each theme), four piece sets or a folder of your own, move sounds (off by
default), and engine logos shown in Live, on the big screen and on the broadcast page.
Books
- Generate Chess324 book: Larry Kaufman's 324 start positions, or only the 18 symmetrical ones, as an EPD book.
- Build a Polyglot book… from a PGN file: depth, minimum games per move, weights by score or by count, a rating
filter, in the background.
Help
- The guide is built into the program, in all eight languages of the interface, for the version that runs, without a
network: F1 opens it in a panel at the right of the page, at the section of what is under the mouse (a row of the
setup, a card of the home page, a tab, a column), and the page keeps working beside it. The panel has its
contents, back and forward (Alt+Left, Alt+Right, the mouse's side buttons), a search that finds every word in any
order, accents and case aside, links between sections, Copy on commands and Open in the browser. - Controls whose label does not say what they do have a tooltip that does, and the tooltip of a control the guide
explains ends with F1: more in the guide; the command palette finds the guide's sections by their titles and
searches it; a problem the program reports has a?to its entry of the new Troubleshooting section. - The guide itself has a quick start, every keyboard shortcut in one table, tips for choosing the settings,
troubleshooting and a glossary of the testers' words, and one section per setting where the tabs had long table
cells. - Until a first tournament is started, the home page shows the steps of the quick start with their buttons.
- A section whose translation is missing or older than the English text is shown in English, saying so; a test
keeps every translation complete and up to date.
The program
- The window reopens as it was left: size, place and maximized state, brought back on screen if a monitor is gone.
- The version in the window title and in Settings, with Copy; optionally (off by default) a notice when a new
version is out, checked once a day. Nothing is downloaded. - Report a problem… opens a new GitHub issue in the browser, filled with the version, the system, the graphics
driver and the last lines of the log, for you to edit before sending. Nothing is sent by the program. - A portable mode: a file named
portablebeside the program keeps everything in adatafolder beside it, with
the paths of its folder kept relative so it can move. - Without OpenGL 3.2 (virtual machines, remote desktops, old drivers) the window is drawn by SDL's renderer, in
software if need be;--softwareor a setting forces it.
Fixes
- Tablebase adjudication could give a wrong result when a black pawn on b2 could take a white piece on a1: the capture
was taken for an en passant one and the tables probed for an impossible position. Fixed in the vendored fastchess,
with four other bugs Coverity Scan found there. - A FEN with move number 0 started its game at move 32768, in the PGN and for the move threshold of draw adjudication.
- An error nothing else caught ended the program without a word on Windows: it is now told, in a message box for the
window. - Clicking the opening chosen in Openings again could read outside the list of openings.
- The dates of the rating charts are in local time, no longer in UTC.
Downloads
| File | Contents |
|---|---|
fastchess-gui-v0.6.0-linux-x86_64.tar.gz |
fastchess-gui, x86-64 Linux (glibc 2.35 or newer). Needs X11 or Wayland. |
fastchess-gui-v0.6.0-windows-x86_64.zip |
fastchess-gui.exe, 64-bit Windows 10 version 1903 or newer. No installer, nothing else to install. |
fastchess-gui-v0.6.0-macos-universal.zip |
fastchess-gui.app and the fastchess command line tool, macOS 13.3 or newer, Apple silicon and Intel. Not signed: Control-click it and choose Open the first time. |
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, and of the piece sets (see ATTRIBUTION.md).
Known limitations
They are tracked as issues labelled known limitation.