Patch Notes - Version History

v2.3.0 - Theme Engine, Progressive Analysis, Lichess Explorer & Feedback System (Latest)

New Features

Complete Light Mode & Dynamic Theme System - Full Light Mode support with tailored high-contrast boards and palettes, backed by a unified QSS template engine and instant live repainting without restarting.
Live Move-by-Move Analysis - Positions, evaluations, best moves, and classification badges now stream onto the board, move list, and eval bar in real time as each move is evaluated.
Lichess Opening Explorer Integration - Real-time position lookups against Lichess Masters & public databases, featuring color-coded Win/Draw/Loss ratio bars and local 2-day caching.
Enhanced Online Game Import - Fetch game archives by specific dates, load matches directly via URL/Game ID, with automatic local caching for fast offline repeat loads.
History View Redesign - Modern desktop game cards with time control badges (Bullet, Blitz, Rapid), view mode toggle (Detailed Cards vs. Compact Table), custom date range picker, and no-scroll pagination.
Automatic Game Termination Detector - Automatic detection and custom visual badges for Checkmate, Resignation, Timeout, Stalemate, Abandonment, and Insufficient Material, paired with a POV-aware result banner.
In-App Reviews & Feedback System - Unified 3-channel modal for Bug Reports (with 1-click diagnostic log attachments), Feature Suggestions, and Reviews.
Custom Toast & Dialog System - Replaced jarring native OS popups with smooth floating toast alerts and styled confirmation dialogs.

Improvements

Analysis UI & Report Card Overhaul - Redesigned header with POV-aware result banners, circular accuracy meters, and high-contrast Electric Cyan evaluation graph cursor pin.
Live Accent Repainting - Changing accent colors immediately updates sidebars, buttons, badges, and highlights in real time without requiring an app restart.
Card-Based Settings View - Overhauled settings tabs with clean surface cards, segmented pill selectors, and password toggles.
Codebase Modularization - Modularized internal page and explorer views to ensure smoother transitions and faster page loads.

Bug Fixes

Stockfish Downloader Resilience - Fixed engine auto-downloader failures caused by upstream asset naming changes on the official Stockfish GitHub releases across Apple Silicon, Intel macOS, Windows, and Linux.
Theme Color Leaks - Removed hardcoded background and border colors in Move Cells, Settings tabs, and Report Cards when toggling between themes.
POV Result Calculation - Fixed banner computations where games were occasionally marked as defeat when playing as Black in winning positions.
Legal Move Indicators - Fixed a visual glitch where move destination dots appeared jagged on certain displays.
Re-Analysis Freshness - Properly resets raw move history when re-analyzing games with altered engine depth.

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

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.3.0 - Theme Engine, Progressive Analysis, Lichess Explorer & Feedback System (Latest)

New Features

Complete Light Mode & Dynamic Theme System - Full Light Mode support with tailored high-contrast boards and palettes, backed by a unified QSS template engine and instant live repainting without restarting.
Live Move-by-Move Analysis - Positions, evaluations, best moves, and classification badges now stream onto the board, move list, and eval bar in real time as each move is evaluated.
Lichess Opening Explorer Integration - Real-time position lookups against Lichess Masters & public databases, featuring color-coded Win/Draw/Loss ratio bars and local 2-day caching.
Enhanced Online Game Import - Fetch game archives by specific dates, load matches directly via URL/Game ID, with automatic local caching for fast offline repeat loads.
History View Redesign - Modern desktop game cards with time control badges (Bullet, Blitz, Rapid), view mode toggle (Detailed Cards vs. Compact Table), custom date range picker, and no-scroll pagination.
Automatic Game Termination Detector - Automatic detection and custom visual badges for Checkmate, Resignation, Timeout, Stalemate, Abandonment, and Insufficient Material, paired with a POV-aware result banner.
In-App Reviews & Feedback System - Unified 3-channel modal for Bug Reports (with 1-click diagnostic log attachments), Feature Suggestions, and Reviews.
Custom Toast & Dialog System - Replaced jarring native OS popups with smooth floating toast alerts and styled confirmation dialogs.

Improvements

Analysis UI & Report Card Overhaul - Redesigned header with POV-aware result banners, circular accuracy meters, and high-contrast Electric Cyan evaluation graph cursor pin.
Live Accent Repainting - Changing accent colors immediately updates sidebars, buttons, badges, and highlights in real time without requiring an app restart.
Card-Based Settings View - Overhauled settings tabs with clean surface cards, segmented pill selectors, and password toggles.
Codebase Modularization - Modularized internal page and explorer views to ensure smoother transitions and faster page loads.

Bug Fixes

Stockfish Downloader Resilience - Fixed engine auto-downloader failures caused by upstream asset naming changes on the official Stockfish GitHub releases across Apple Silicon, Intel macOS, Windows, and Linux.
Theme Color Leaks - Removed hardcoded background and border colors in Move Cells, Settings tabs, and Report Cards when toggling between themes.
POV Result Calculation - Fixed banner computations where games were occasionally marked as defeat when playing as Black in winning positions.
Legal Move Indicators - Fixed a visual glitch where move destination dots appeared jagged on certain displays.
Re-Analysis Freshness - Properly resets raw move history when re-analyzing games with altered engine depth.

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

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.3.0 - Theme Engine, Progressive Analysis, Lichess Explorer & Feedback System (Latest)

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

v2.0.1 -Unified Load Dialog & UI Polish

New Features

Improvements

v1.7 -Groq API Integration & Lichess Auth Fix

New Features

Bug Fixes

v1.6 -UX Enhancements & Auto-Update

New Features

Improvements

v1.5 -Themes, Stats Overhaul & Polish

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

v1.3 -Data, UI Polish & AI Coach

New Features

Improvements

Bug Fixes

v1.2 -UI Overhaul & Metrics Dashboard

New Features

Improvements

v1.1 -Analysis Refinements & UI Fixes

New Features

Improvements

Bug Fixes

Ready to analyze your chess games?

v2.3.0 - Theme Engine, Progressive Analysis, Lichess Explorer & Feedback System (Latest)

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

v2.0.1 -Unified Load Dialog & UI Polish

New Features

Improvements

v1.7 -Groq API Integration & Lichess Auth Fix

New Features

Bug Fixes

v1.6 -UX Enhancements & Auto-Update

New Features

Improvements

v1.5 -Themes, Stats Overhaul & Polish

New Features

Improvements

Bug Fixes

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

New Features

Improvements

Bug Fixes

v1.3 -Data, UI Polish & AI Coach

New Features

Improvements

Bug Fixes

v1.2 -UI Overhaul & Metrics Dashboard

New Features

Improvements

v1.1 -Analysis Refinements & UI Fixes

New Features

Improvements