Configuration

Customize Chess Analyzer Pro to fit your workflow. All settings are saved locally and most apply immediately without requiring a restart.

1. Stockfish Engine (Required)

The analyzer requires a local Stockfish executable to function.

1. Download Stockfish from stockfishchess.org.
2. Unzip the file to a known location (e.g., inside a stockfish/ folder in the project root).
3. In the app, go to Settings (Gear Icon) > Chess Engine.
4. Click Browse and select the stockfish.exe (Windows) or stockfish (Mac/Linux) binary.
5. Click Save Engine Path.

[!IMPORTANT] Make sure to select the actual executable file, not the folder containing it.

2. API Configuration

Unlock advanced features by adding your API keys. Keys are stored locally in config.json and apply immediately after saving.

Gemini API (AI Summary & Coaching)

Required for the AI Summary feature and AI Coach Insights on the Stats page.

1. Get a free key from Google AI Studio.
2. Go to Settings > API Configuration.
3. Paste your key into the Gemini API Key field.
4. Click Save.

Lichess API (Import Games)

Required for importing your games from Lichess.

1. Log in to your Lichess account.
2. Go to Preferences > API Access Tokens (or visit lichess.org/account/oauth/token).
3. Create a new Personal Access Token with the scope Read games.
4. Copy the token and paste it into the Lichess API Token field in Settings.
5. Click Save.

[!NOTE] The Lichess token is optional. Without it, you can still load games from public profiles, but rate limits may apply.

3. Player Profiles

Pre-fill your usernames to speed up game loading and enable personalized statistics.

• Go to Settings > Player Usernames.
• Enter your Chess.com username.
• Enter your Lichess username.
• Click Save.

These usernames will:

• Auto-populate in the "Load Game" dialogs.
• Filter the Stats dashboard to show only your games.
• Enable the "Performance by Color" analysis.

4. Appearance

Accent Color

Choose a primary color for buttons, highlights, and active elements.

1. Go to Settings > Appearance.
2. Click the Accent Color button.
3. Select your preferred color from the color picker.
4. The change applies immediately.

Theme (Dark/Light Mode)

Toggle between Light and Dark mode using the sun/moon icon in the sidebar.

Board Theme

Customize the chessboard square colors.

1. Go to Settings > Appearance > Board Theme.
2. Select from available themes:
   • Default - Classic green/cream
   • Brown - Traditional wood tones
   • Blue - Modern blue scheme
   • Purple - Royal purple accents
   • Grey - Minimalist neutral
3. The board updates immediately.

Piece Theme

Choose your preferred piece set style.

1. Go to Settings > Appearance > Piece Theme.
2. Select from available piece sets:
   • cburnett - Colin M.L. Burnett's clean SVG set
   • merida - Classic tournament style
   • alpha - Bold, modern design
   • cardinal - Ornate traditional pieces
   • chess7 - Stylized contemporary set
3. The pieces update immediately.

5. Data Management

Clear Analysis Cache

Remove cached engine analysis to free up disk space or force re-analysis.

1. Go to Settings > Data Management.
2. Click Clear Cache.
3. Confirm the action.

[!WARNING] This only clears the position analysis cache, not your game history.

Clear All Data

Remove all data including game history and cache.

1. Go to Settings > Data Management.
2. Click Clear All Data.
3. Confirm the action.

[!CAUTION] This permanently deletes all analyzed games. Consider exporting to CSV first!

6. Configuration File Reference

All settings are stored in config.json in the application root. While it's recommended to use the in-app Settings panel, you can manually edit this file if needed.

{
    "engine_path": "stockfish/stockfish.exe",
    "theme": "dark",
    "gemini_api_key": "your-api-key-here",
    "lichess_token": "lip_xxxx",
    "lichess_username": "your_lichess_name",
    "chesscom_username": "your_chesscom_name",
    "accent_color": "#4CAF50",
    "board_theme": "default",
    "piece_theme": "cburnett"
}