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 or user data folder).
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.
6. Click the Test Engine validation button to verify the binary path works correctly.

[!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.

LLM Configuration & Profiles (AI Summary & Coaching)

Required for the AI Summary feature and AI Coach Insights on the Stats page. The application supports profile-based LLM configurations, allowing you to configure multiple provider setups and switch between them.

1. Go to Settings > API Configuration.
2. Under LLM Configuration Profiles, you can add or manage profiles. Natively supported providers are:
   • Groq: High-speed cloud model hosting. Enter your Groq API Key and Model ID (defaults to llama-3.3-70b-versatile).
   • LM Studio: Run local LLMs. Enter the local base URL (usually http://localhost:1234/v1) and Model ID.
   • MiniMax: Cloud model hosting. Enter your API Key and Model ID.
   • Custom: Any OpenAI-compatible endpoint. Enter API Key, Base URL, and Model ID.
3. Click Save Profile.
4. Select your desired active profile from the dropdown list. All AI comments and summaries will dynamically use the active profile.

Lichess API (Import Games & Book Moves)

Required for importing your games from Lichess and fetching book move names from the Lichess Opening Explorer.

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 (needed to authenticate Opening Explorer queries).
4. Copy the token and paste it into the Lichess API Token field in Settings.
5. Click Save.

[!IMPORTANT] A Lichess API Token is now required to avoid 401 Unauthorized blocks when retrieving opening explorer book move names. Without it, the app will still function, but book move names will not load.

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 & Audio

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, updating the entire application visual system in real time.

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.

Sound Effects

Enable or disable sound effects during games:

1. Go to Settings > Appearance.
2. Check or uncheck Enable Sound Effects to toggle audio feedback for moves, captures, checks, castles, and loading.

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 inside the platform-specific user data directory. While it's recommended to use the in-app Settings panel, you can manually edit this file if needed.

{
    "engine_path": "stockfish",
    "theme": "dark",
    "sound_enabled": true,
    "lichess_token": "lip_xxxx",
    "lichess_username": "your_lichess_name",
    "chesscom_username": "your_chesscom_name",
    "accent_color": "#4CAF50",
    "board_theme": "default",
    "piece_theme": "cburnett",
    "analysis_depth": 18,
    "api_games_limit": 20,
    "multi_pv": 1,
    "live_analysis_time": 2.0,
    "llm_profiles": [
        {
            "name": "Groq",
            "provider": "groq",
            "api_key": "gsk_xxxx",
            "model": "llama-3.3-70b-versatile",
            "base_url": ""
        }
    ],
    "llm_active_profile": "Groq"
}