Patch Notes -Version History

v2.2.0 -Custom Themes, Setup Wizard & UX Polish (Latest)

New Features

Custom Piece Theme Import -Import folders of 12 SVG piece images via Appearance Settings. SVGs are auto-scaled, normalized, and rendered with gradient/grouping support.
First-Run Setup Wizard -Multi-page configuration guide on first startup for engine paths, LLM providers, online accounts, and appearance.
Auto-Engine Resolution & Downloader -Automatically resolves Stockfish binary across config, system PATH, common install paths, and local downloads. Includes an integrated downloader to fetch the latest platform-appropriate binary from GitHub.
Dynamic Chess Clocks -Monospaced clocks next to captured pieces that update in real time from PGN time data, with a red alert under 20 seconds.
Overhauled Interactive Tours -Non-intrusive guided tours with target-pulsing accent glows and floating tooltips that only trigger when page content is loaded.

Improvements

Basic/Advanced Settings Toggle -Simplified settings view by default, with an advanced toggle for fine-tuning engine parameters.
Context-Aware Error Dialogs -Custom dialogs (EngineNotFoundDialog, LlmNotConfiguredDialog) with direct action links to settings.
Engine Resolution Disk Caching -Prevents repeated CPU/disk overhead during startup and page transitions.
UI & Font Polish -macOS SF Pro font stack integration, Gatekeeper self-fix for app bundles, dark-themed dialog updates.
Config Legacy Cleanup -Automated cleanup of stale flat keys (groq_api_key, groq_model) on load.

Bug Fixes

Checkmate evaluation no longer returns Mate(0) -correctly identifies the winning side with Mate(-1).
Explorer page double-layout evaluation bar spacing (24px right-shift) resolved; coordinate grid overlays fixed.
PGN parser now rejects files with no playable moves; "Try Again" button on parse failure dialogs.
Label text clipping in opening name panels fixed with word wrap; gray background boxes removed from global styling.

v2.1.0 -Analysis Explorer, Polyglot Books & Auto-Update

New Features

Analysis Explorer -Interactive explorer with independent board, move list, opening book integration, live engine analysis, and move classification.
Polyglot Opening Books -Support for Polyglot binary opening books (.bin) configurable in Settings.
Auto-Update Framework -Cross-platform update mechanism with native installers (Inno Setup for Windows, DMG for macOS, AppImage for Linux).

Improvements

Code Restructuring -Backend split into analysis/, api/, services/, storage/, updater/; GUI split into board/, analysis/, components/, dialogs/, views/, utils/.
Settings Reorganization -Dedicated views for API, Appearance, Engine, Player, Data, Book, and Links.
Modular Metrics Dashboard -Card-based layout with separate components for accuracy, color performance, move quality, and opening stats.
Classification Algorithm Tuning -Adjusted Blunder/Mistake/Inaccuracy thresholds for better Chess.com alignment.
Unified Load Dialog -Modular panel components for PGN file, PGN text, Chess.com, and Lichess.
Local Opening Books -Local book moves as alternative to Lichess API dependency.

Bug Fixes

Chess960 flag now persists across game save/load cycles.
PGN export correctly sets the starting FEN header for AI summary export.
Fixed crashes when switching between PGN loading and history views.
Engine analysis no longer freezes when switching between Polyglot and internal books.
Unbounded engine search depth fixed -now uses configured time per move.
Live engine worker properly stopped on application exit.
Config reloading and API profile validation fixed.
Header styling and accent color inconsistencies resolved across pages.

v2.0.1 -Unified Load Dialog & UI Polish

New Features

Unified Load Game Dialog -Single modal for all game sources (PGN file, PGN text, Chess.com, Lichess) with async loading.
History Pagination & Per-Game Delete -Game history loads page by page with individual deletion.
Multi-LLM Profile Support -Profile-based configurations for Groq, LM Studio, MiniMax, and Custom providers.
Stockfish Path Validator -"Test Engine" button in Settings with immediate visual feedback.
Evaluation Graph Navigation -Click any point on the graph to jump to that move.
Dynamic Accent Color -UI updates in real time without restart.
Real-Time Engine Status -Status bar showing Engine Ready, Calculating, and Offline states.
Sound Effects Toggle -Switch sounds on/off in Settings.
Configurable Game Fetch Limit -Control online fetch count (1–30 games).

Improvements

Local Data Paths -Migrated config, database, and logs to OS-standard user data folders.
Live Engine CPU Optimization -Conservative multi-PV defaults and configurable time budget to prevent overheating.
Fixed Lichess 401 Unauthorized errors on Opening Explorer requests.
Analysis worker thread properly closed on exit.
Enhanced keyboard navigation (arrow keys, Home/End, graph navigation).
Move count display no longer truncated past 9.

v1.7 -Groq API Integration & Lichess Auth Fix

New Features

Groq API Integration -Switched from deprecated google.generativeai (Gemini) SDK to the official Groq SDK.
Configurable AI Models -Change the Groq model ID directly in Settings.

Bug Fixes

Lichess Opening Explorer now uses authenticated requests with personal tokens, fixing 401 errors.
Evaluation graph height locked to intrinsic height -no more jumping when paging games.
Captured pieces split into two single-side rows with locked heights.
Board widget stays strictly square during resize with aligned evaluation bar.

v1.6 -UX Enhancements & Auto-Update

New Features

Auto-Update Check -Startup update check with one-click download.
Keyboard Shortcuts -Arrow keys, Home/End, F for board flip, Ctrl+O to load, F1 for help.
Shortcuts Help Dialog -Press F1 to see all available shortcuts.
History Search & Filters -Search by player, opening, event, date, ECO code; filter by result and source.

Improvements

Consistent Icon System -QtAwesome (FontAwesome) icons throughout.
Configurable Engine Depth -Choose analysis depth from 10 to 25 in Settings.
UI Polish -Consistent typography, muted color palette, clean card layout, button style variants.

v1.5 -Themes, Stats Overhaul & Polish

New Features

Splash Screen -Startup screen for a polished launch experience.
Board & Piece Themes -Customizable board colors and piece sets.
Live Settings Update -All settings apply immediately without restart.
Stats by Piece Color -Performance metrics broken down by White vs Black.

Improvements

Stats Page Overhaul -Completely redesigned Metrics dashboard.
Accuracy Algorithm Overhaul -Lichess-style volatility-weighted harmonic mean, proper win probability conversion, tuned thresholds.
Move Classification -Checkmate always classified as "Best"; tightened Inaccuracy/Mistake/Blunder thresholds; book moves get 100% accuracy.

Bug Fixes

_analyze_final_position now correctly returns the score.
Safeguards prevent moves from getting 0% accuracy.

v1.4 -Load Options, Data Backup & UI Overhaul

New Features

Lichess URL Loading -Load games directly from Lichess game links.
Paste PGN -Quick-load games by pasting PGN text.
CSV Export/Import -Export and import game history for backup.
Settings Overhaul -Completely redesigned Settings UI with centered layout.

Improvements

Game History -Visual source indicators (Lichess, Chess.com, PGN) in the history list.
Code Quality -Major refactoring with integrity tests.

Bug Fixes

Fixed unresponsive "Go to Settings" button.
Missing ELO ratings on loaded games now populate correctly.
Duplicate entries on import no longer appear.

v1.3 -Data, UI Polish & AI Coach

New Features

Lichess Support -Load games directly from Lichess usernames.
Ending Distribution Chart -Visualizes game outcomes by type (Checkmate, Resignation, Time, Abandon).
Loading Overlay -Non-blocking overlay while fetching games from online APIs.

Improvements

AI Coach -Refreshed UI with Refresh button, markdown/emoji stripping, and placeholder state.
Data Enrichment -Database now stores opening names, player ratings, termination type, and FEN strings.
Game List -Results clearly visible in the game selection dialog.

Bug Fixes

Checkmates no longer incorrectly classified as Blunders.
Book move counts no longer double-counted in summaries.

v1.2 -UI Overhaul & Metrics Dashboard

New Features

Metrics Dashboard -Stats page with Overview, Move Quality, and Openings tabs.
Modern Sidebar UI -Sleek integrated sidebar replacing the top menu bar.
Chess.com Game Selection -Dialog with game details when loading from Chess.com.

Improvements

Better spacing and arrangement of the analysis panel.
Fixed QFont warnings; added Exit button to sidebar.

v1.1 -Analysis Refinements & UI Fixes

New Features

Game History -Auto-saves analyzed games with last-game restoration on startup.

Improvements

"Miss" Classification -Detects missed wins and missed checkmates.
Accuracy Formula -Reverted to 100 × exp(-0.004 × acpl) for consistent scoring.
Best Move Visibility -Fixed missing icons in move list and on board.
Game Info Header -Displays "White (Elo) vs Black (Elo) [Result]".

Bug Fixes

Mate scores correctly converted to capped centipawn values for ACPL calculation.
Fixed NameError and AttributeError crashes on startup.

v2.2.0 -Custom Themes, Setup Wizard & UX Polish (Latest)

New Features

Custom Piece Theme Import -Import folders of 12 SVG piece images via Appearance Settings. SVGs are auto-scaled, normalized, and rendered with gradient/grouping support.
First-Run Setup Wizard -Multi-page configuration guide on first startup for engine paths, LLM providers, online accounts, and appearance.
Auto-Engine Resolution & Downloader -Automatically resolves Stockfish binary across config, system PATH, common install paths, and local downloads. Includes an integrated downloader to fetch the latest platform-appropriate binary from GitHub.
Dynamic Chess Clocks -Monospaced clocks next to captured pieces that update in real time from PGN time data, with a red alert under 20 seconds.
Overhauled Interactive Tours -Non-intrusive guided tours with target-pulsing accent glows and floating tooltips that only trigger when page content is loaded.

Improvements

Basic/Advanced Settings Toggle -Simplified settings view by default, with an advanced toggle for fine-tuning engine parameters.
Context-Aware Error Dialogs -Custom dialogs (EngineNotFoundDialog, LlmNotConfiguredDialog) with direct action links to settings.
Engine Resolution Disk Caching -Prevents repeated CPU/disk overhead during startup and page transitions.
UI & Font Polish -macOS SF Pro font stack integration, Gatekeeper self-fix for app bundles, dark-themed dialog updates.
Config Legacy Cleanup -Automated cleanup of stale flat keys (groq_api_key, groq_model) on load.

Bug Fixes

Checkmate evaluation no longer returns Mate(0) -correctly identifies the winning side with Mate(-1).
Explorer page double-layout evaluation bar spacing (24px right-shift) resolved; coordinate grid overlays fixed.
PGN parser now rejects files with no playable moves; "Try Again" button on parse failure dialogs.
Label text clipping in opening name panels fixed with word wrap; gray background boxes removed from global styling.

v2.1.0 -Analysis Explorer, Polyglot Books & Auto-Update

New Features

Analysis Explorer -Interactive explorer with independent board, move list, opening book integration, live engine analysis, and move classification.
Polyglot Opening Books -Support for Polyglot binary opening books (.bin) configurable in Settings.
Auto-Update Framework -Cross-platform update mechanism with native installers (Inno Setup for Windows, DMG for macOS, AppImage for Linux).

Improvements

Code Restructuring -Backend split into analysis/, api/, services/, storage/, updater/; GUI split into board/, analysis/, components/, dialogs/, views/, utils/.
Settings Reorganization -Dedicated views for API, Appearance, Engine, Player, Data, Book, and Links.
Modular Metrics Dashboard -Card-based layout with separate components for accuracy, color performance, move quality, and opening stats.
Classification Algorithm Tuning -Adjusted Blunder/Mistake/Inaccuracy thresholds for better Chess.com alignment.
Unified Load Dialog -Modular panel components for PGN file, PGN text, Chess.com, and Lichess.
Local Opening Books -Local book moves as alternative to Lichess API dependency.

Bug Fixes

Chess960 flag now persists across game save/load cycles.
PGN export correctly sets the starting FEN header for AI summary export.
Fixed crashes when switching between PGN loading and history views.
Engine analysis no longer freezes when switching between Polyglot and internal books.
Unbounded engine search depth fixed -now uses configured time per move.
Live engine worker properly stopped on application exit.
Config reloading and API profile validation fixed.
Header styling and accent color inconsistencies resolved across pages.

v2.0.1 -Unified Load Dialog & UI Polish

New Features

Unified Load Game Dialog -Single modal for all game sources (PGN file, PGN text, Chess.com, Lichess) with async loading.
History Pagination & Per-Game Delete -Game history loads page by page with individual deletion.
Multi-LLM Profile Support -Profile-based configurations for Groq, LM Studio, MiniMax, and Custom providers.
Stockfish Path Validator -"Test Engine" button in Settings with immediate visual feedback.
Evaluation Graph Navigation -Click any point on the graph to jump to that move.
Dynamic Accent Color -UI updates in real time without restart.
Real-Time Engine Status -Status bar showing Engine Ready, Calculating, and Offline states.
Sound Effects Toggle -Switch sounds on/off in Settings.
Configurable Game Fetch Limit -Control online fetch count (1–30 games).

Improvements

Local Data Paths -Migrated config, database, and logs to OS-standard user data folders.
Live Engine CPU Optimization -Conservative multi-PV defaults and configurable time budget to prevent overheating.
Fixed Lichess 401 Unauthorized errors on Opening Explorer requests.
Analysis worker thread properly closed on exit.
Enhanced keyboard navigation (arrow keys, Home/End, graph navigation).
Move count display no longer truncated past 9.

v1.7 -Groq API Integration & Lichess Auth Fix

New Features

Groq API Integration -Switched from deprecated google.generativeai (Gemini) SDK to the official Groq SDK.
Configurable AI Models -Change the Groq model ID directly in Settings.

Bug Fixes

Lichess Opening Explorer now uses authenticated requests with personal tokens, fixing 401 errors.
Evaluation graph height locked to intrinsic height -no more jumping when paging games.
Captured pieces split into two single-side rows with locked heights.
Board widget stays strictly square during resize with aligned evaluation bar.

v1.6 -UX Enhancements & Auto-Update

New Features

Auto-Update Check -Startup update check with one-click download.
Keyboard Shortcuts -Arrow keys, Home/End, F for board flip, Ctrl+O to load, F1 for help.
Shortcuts Help Dialog -Press F1 to see all available shortcuts.
History Search & Filters -Search by player, opening, event, date, ECO code; filter by result and source.

Improvements

Consistent Icon System -QtAwesome (FontAwesome) icons throughout.
Configurable Engine Depth -Choose analysis depth from 10 to 25 in Settings.
UI Polish -Consistent typography, muted color palette, clean card layout, button style variants.

v1.5 -Themes, Stats Overhaul & Polish

New Features

Splash Screen -Startup screen for a polished launch experience.
Board & Piece Themes -Customizable board colors and piece sets.
Live Settings Update -All settings apply immediately without restart.
Stats by Piece Color -Performance metrics broken down by White vs Black.

Improvements

Stats Page Overhaul -Completely redesigned Metrics dashboard.
Accuracy Algorithm Overhaul -Lichess-style volatility-weighted harmonic mean, proper win probability conversion, tuned thresholds.
Move Classification -Checkmate always classified as "Best"; tightened Inaccuracy/Mistake/Blunder thresholds; book moves get 100% accuracy.

Bug Fixes

_analyze_final_position now correctly returns the score.
Safeguards prevent moves from getting 0% accuracy.

v1.4 -Load Options, Data Backup & UI Overhaul

New Features

Lichess URL Loading -Load games directly from Lichess game links.
Paste PGN -Quick-load games by pasting PGN text.
CSV Export/Import -Export and import game history for backup.
Settings Overhaul -Completely redesigned Settings UI with centered layout.

Improvements

Game History -Visual source indicators (Lichess, Chess.com, PGN) in the history list.
Code Quality -Major refactoring with integrity tests.

Bug Fixes

Fixed unresponsive "Go to Settings" button.
Missing ELO ratings on loaded games now populate correctly.
Duplicate entries on import no longer appear.

v1.3 -Data, UI Polish & AI Coach

New Features

Lichess Support -Load games directly from Lichess usernames.
Ending Distribution Chart -Visualizes game outcomes by type (Checkmate, Resignation, Time, Abandon).
Loading Overlay -Non-blocking overlay while fetching games from online APIs.

Improvements

AI Coach -Refreshed UI with Refresh button, markdown/emoji stripping, and placeholder state.
Data Enrichment -Database now stores opening names, player ratings, termination type, and FEN strings.
Game List -Results clearly visible in the game selection dialog.

Bug Fixes

Checkmates no longer incorrectly classified as Blunders.
Book move counts no longer double-counted in summaries.

v1.2 -UI Overhaul & Metrics Dashboard

New Features

Metrics Dashboard -Stats page with Overview, Move Quality, and Openings tabs.
Modern Sidebar UI -Sleek integrated sidebar replacing the top menu bar.
Chess.com Game Selection -Dialog with game details when loading from Chess.com.

Improvements

Better spacing and arrangement of the analysis panel.
Fixed QFont warnings; added Exit button to sidebar.

v1.1 -Analysis Refinements & UI Fixes

New Features

Game History -Auto-saves analyzed games with last-game restoration on startup.

Improvements

"Miss" Classification -Detects missed wins and missed checkmates.
Accuracy Formula -Reverted to 100 × exp(-0.004 × acpl) for consistent scoring.
Best Move Visibility -Fixed missing icons in move list and on board.
Game Info Header -Displays "White (Elo) vs Black (Elo) [Result]".

Bug Fixes

Mate scores correctly converted to capped centipawn values for ACPL calculation.
Fixed NameError and AttributeError crashes on startup.