Usage Guide
Master the features of Chess Analyzer Pro.
Loading Games
1. By PGN File
Import a local game file (.pgn).
- Click the Load Game dropdown in the sidebar.
- Select Open PGN File....
- Browse to and select your
.pgnfile. - If the file contains multiple games, a selection dialog will appear.
2. By Username (Chess.com)
Fetch your recent games from Chess.com.
- Click Load Game > From Chess.com User....
- Enter your Chess.com username (or it auto-fills if configured in Settings).
- A dialog shows your last 5 games with opponent, date, and rating.
- Select a game to analyze.
3. By Username (Lichess)
Fetch your recent games from Lichess.org.
- Click Load Game > From Lichess User....
- Enter your Lichess username.
- Select a game from the list.
4. By Game URL (Chess.com)
Analyze a specific Chess.com game by its link.
- Click Load Game > From Chess.com Link....
- Paste the game URL (e.g.,
https://www.chess.com/game/live/123456789). - The game loads automatically.
5. By Game URL (Lichess)
Analyze a specific Lichess game by its link.
- Click Load Game > From Lichess Link....
- Paste the game URL (e.g.,
https://lichess.org/AbCdEfGh). - The game loads automatically.
6. Paste PGN Text
Quickly load a game by pasting PGN from your clipboard.
- Click Load Game > Paste PGN....
- In the dialog, paste your PGN text.
- Click Load to import the game.
Analysis Features
Once a game is loaded, the Stockfish engine is ready to analyze.
Start Analysis
Click the Analyze Game button in the sidebar. The engine will evaluate every move, calculating:
- Win probabilities
- Best lines for each position
- Move accuracy scores
- Move classifications
A progress bar shows the current analysis status.
Navigation
- Arrow Keys: Navigate move-by-move (Left/Right for previous/next).
- Home/End: Jump to the first/last move.
- Evaluation Graph: Click any point on the graph to jump to that moment.
- Move List: Click a move to view the board state.
Move Classification
Moves are color-coded based on their quality:
| Icon | Classification | Description | Color |
|---|---|---|---|
| š | Brilliant | Exceptional, often sacrificial play | Cyan |
| ā | Great | The only good move in a critical position | Teal |
| ā | Best | Matches the engine's top recommendation | Green |
| ā | Excellent | Very strong move, minimal accuracy loss | Light Green |
| ā | Good | Solid move, small accuracy loss | Yellow-Green |
| ?! | Inaccuracy | A suboptimal move, but not serious | Yellow |
| ? | Mistake | A significant error affecting the evaluation | Orange |
| ?? | Blunder | A critical error that likely loses the game | Red |
| ā | Miss | Missed a winning opportunity or forced mate | Purple |
| š | Book | An opening book move (theory) | Blue |
Analysis Lines
When viewing a position after analysis, the right panel shows:
- Top 3 engine lines with evaluations
- Move sequence for each variation
- Centipawn/Mate scores for each line
AI Game Summary
[!IMPORTANT] Requirement: Valid Gemini API Key in Settings.
After analysis completes:
- Click the AI Summary button or tab (Robot Icon).
- Wait for Gemini to generate the summary.
- The AI provides:
- A Game Comment (e.g., "Tactical Masterpiece", "Chaotic Fight")
- A Narrative Summary highlighting key turning points and critical moments
Statistics Dashboard
The Stats tab provides comprehensive insights into your chess performance across all analyzed games.
Overview Metrics
- Total Games: Number of games analyzed
- Win Rate: Percentage of games won
- Average Accuracy: Mean accuracy across all games
- Most Played Opening: Your most frequent opening
Performance Charts
| Chart | Description |
|---|---|
| Results Donut | Win/Loss/Draw distribution |
| Termination Donut | How games ended (Checkmate, Resignation, Time, etc.) |
| Accuracy Trend | Line chart showing accuracy over recent games |
| Performance by Color | Win rates when playing as White vs Black |
Openings Analysis
View your most played openings with:
- Frequency count
- Win rate for each opening
- Visual bar representation
AI Coach Insights
[!NOTE] Requires Gemini API key.
Click Refresh Insights to generate personalized coaching tips based on your statistics. The AI analyzes your patterns and provides 3 actionable suggestions.
Game History
The History tab keeps a log of all analyzed games.
Features
- Browse: See all saved games with date, players, result, and source icon.
- Reload: Double-click a game to reload it instantly from the cache.
- Delete: Right-click a game to remove it from history.
- Search: Filter games by player name or opening.
Source Icons
| Icon | Source |
|---|---|
| š | Chess.com |
| ā | Lichess |
| š | PGN File |
Data Backup
Export History to CSV
- Go to the History tab.
- Click Export (or use the menu).
- Choose a save location.
- All game metadata and statistics are saved to
games.csv.
Import History from CSV
- Go to the History tab.
- Click Import.
- Select your previously exported
games.csv. - Games are restored (duplicates are automatically skipped).
Keyboard Shortcuts
| Key | Action |
|---|---|
ā (Left Arrow) | Previous move |
ā (Right Arrow) | Next move |
Home | First move (start position) |
End | Last move (final position) |
F | Flip board orientation |
Ctrl+O | Open PGN file |
Ctrl+A | Start analysis |
Tips & Tricks
- Quick Analysis: Right-click the Analyze button for options like "Analyze from current position".
- Hover for Details: Hover over the evaluation graph to see exact values at each move.
- Classification Filter: Click on a classification icon in the move list to jump to the next occurrence.
- Save Usernames: Configure your usernames in Settings for faster game loading and personalized stats.