Repository navigation

Releases

Lichess Puzzles 3.3.0 Latest

Latest

ianrastall released this 30 Oct 19:24

3.3.0

01cf912

Adds an optional second-engine opinion before a puzzle is presented.

Skip shallow engine solutions uses the existing small Rust engine to search every solver turn, independently of the recorded solution. It skips only completed reviews with consistent agreement across all observed depths, with at least two observations per turn.
Different recommendations and incomplete reviews remain available. The experimental option is off by default, saved with presets, and works alongside exact short-mate screening and fixed near-rating ranges.
Each review has a 50,000-node and soft 75 ms total budget, with reusable results in a separate disposable SQLite cache. Original puzzle files, published ratings, exports and player history are preserved.
The new CLI review command provides individual/sample reports, depth stability and JSON output.

Two 600-record pilot samples show a useful association with published ratings, including a cohort controlling solution length, mate tags, rating deviation and plays. Broad-sample uncached review averaged 9.25 ms on the verification machine. Engine effort is not a calibrated human difficulty rating. See measurements and limitations.

Validation: 58 Rust tests, 62 C#–native integration checks, formatting, Clippy, shared UI style checks, installer upgrade, Start Menu launch, saved presets and restart persistence. Validation details.

Windows x64: choose the setup EXE for installation. The portable ZIP is optional. The source ZIP includes the shared Jupiter.UI library. SHA256 checksums are provided.

Assets 6

Lichess Puzzles 3.2.0

ianrastall released this 30 Oct 18:27

3.2.0

33b63b5

Optional short-mate screening now checks candidates before presentation while keeping the original Lichess puzzle database intact.

Choose Off, Exclude mate in one, or Exclude mate in one or two in the filter pane. Complete checks are cached, and the next candidate is prepared in the background. These checks establish short mates, rather than human difficulty.
Player rating is prominently labeled at the top of both Puzzle and History, with provisional status, rating deviation and rated-puzzle count visible.
Near my rating respects your selected ±75, ±150 or ±300 range. It never silently widens the range. Selection accounts for a pending abandonment loss and retries if player, filter, session or database state changes before the next puzzle starts.
Save screening and rating-range choices in presets. New profiles default to near-rating selection at ±150 and skipping played puzzles; upgrades preserve existing choices.
The original CSV/store, puzzle ratings, history and exports remain available. The local puzzle rating is separate from a Lichess account or over-the-board rating.

Requires Windows 11 24H2 or later, x64. Download the win-x64-setup.exe installer below. Upgrading preserves your puzzle data, players, history and settings. The portable ZIP is an additional option; the source ZIP includes the required Jupiter.UI source snapshot. SHA256 checksums are supplied.

Validation: 50 Rust tests, 55 C#–Rust integration checks, formatting, Clippy and Jupiter style checks. Installed-app verification covers Start Menu launch, prominent player ratings, screening, presets and retained user data.

Assets 6

Lichess Puzzles 3.1.0

ianrastall released this 28 Oct 01:30

3.1.0

3679295

This release fixes setup for users who already downloaded the Lichess puzzle database and lets users choose when to download updates.

Use your existing database: when no readable puzzle store is installed, the app finds lichess_db_puzzle.csv.zst or lichess_db_puzzle.csv beside the executable and imports it automatically. It also checks the app's data folder and legacy source subfolder. Files downloaded outside the app need no download metadata.
Choose when to update: the desktop app now offers local import as the main setup action. File > Get puzzle database from Lichess… opens the download page in your browser. Download a new file when you want, then choose File > Import puzzle file…. In-app downloads and automatic update checks have been removed; CLI download commands remain available.
Keep your source file: desktop imports preserve the original CSV or compressed CSV. Existing installed puzzle stores stay in use until you explicitly import an update.

Thanks to Pasupathy for reporting the database detection issue and suggesting user-managed downloads.

Download the setup.exe for the per-user Windows installer or win-x64.zip for the portable app. Requires Windows 11 24H2 or later, x64. The installer is unsigned. Existing Jupiter settings, puzzles, players and history are retained.

Validation: all 40 Rust tests and 46 C#–Rust interop checks pass, along with formatting, linting, the WinUI build, and the shared UI style check. The packaged app was smoke-tested with a local database beside its executable. The source archive includes the exact shared Jupiter.UI sources used for the build; SHA256 checksums are included.

Assets 6

Lichess Puzzles 3.0.0

ianrastall released this 25 Oct 19:54

3.0.0

7ba9948

Release notes

3.0.0 — 25 October 2026

The Jupiter rebuild of Lichess Puzzle Desktop, with a WinUI 3 shell and Rust core.

Download the Lichess database with pause, resume and update checks, or import CSV/zstd files. Build a compact offline store with legal-position and move validation.
Filter by rating, themes, openings, quality, solver side and solution length; save presets and skip played puzzles.
Solve with click, drag or keyboard input, legal-move markers, hints, promotion, solution navigation and replay.
Keep separate players, Glicko-2 ratings and attempt history; choose puzzles near the player's rating.
Export PGN, CSV and EPD, and optionally display the built-in evaluation engine's score and line.
Choose the shared Jupiter dark, light or Windows theme, accent colour and board appearance.
Switching or deleting the current player restarts the board for the new player; prior attempts remain with their owner. Reopening a played puzzle is an unrated replay and creates no duplicate history.
The Players menu refreshes without accumulating duplicate entries.
Export cancellation and failures preserve existing destination files; temporary files use unique names and are cleaned up automatically.
Evaluation reports checkmate and drawn positions immediately, and distinguishes an interrupted search from a pending result. Hint and navigation controls remain available after a command finishes.
Deliver a self-contained x64 Windows installer with Start Menu and uninstall entries, a portable zip, a complete source bundle including Jupiter.UI, licence notices and SHA256 checksums.

Requires Windows 11 24H2 or later, x64. The installer is unsigned. Existing Jupiter installations upgrade in place and retain puzzles, settings, players and history. The predecessor Lichess Puzzle Desktop installation and data remain separate; automatic migration is not included. The built-in engine is a training aid rather than an authoritative engine.

Assets 6