Skip to content

Latest commit

 

History

History
80 lines (61 loc) · 3.12 KB

Readme.md

File metadata and controls

80 lines (61 loc) · 3.12 KB
Raw

Python GUI Chess Game Analysis with Stockfish

This application allows users to analyze chess games using Stockfish engine, visualize the chessboard, and track game moves with a dynamic evaluation bar.

Table of Contents

Features

  • Chessboard Visualization: Display the chessboard with pieces loaded from PNG files.
  • PGN File Loading: Load a PGN file to analyze a game's moves.
  • Move Navigation: Navigate through game moves, both forward and backward.
  • Evaluation Bar: Visualize the evaluation score dynamically with a split bar indicating advantage for white and black sides.
  • Move History: Display the history of moves made in the game.
  • Stockfish Integration: Use Stockfish engine for game analysis and evaluation.

Installation

  1. Clone the Repository:

    git clone [https://github.com/your-username/Chess-Game-Analysis.git](https://github.com/mominalix/Python-GUI-Chess-Game-Analysis-with-Stockfish.git)
cd Chess-Game-Analysis

  2. Install Dependencies:

    pip install -r requrements.txt

  3. Download Stockfish:

    • Download the appropriate Stockfish binary for your operating system from Stockfish Official Site.
    • Place the downloaded executable in the stockfish directory within your project.

Usage

  1. Run the Application:

    python main.py

  2. Load a PGN File:

    • Click on the "Load PGN" button to load a PGN file containing a chess game.

  3. Navigate Through Moves:

    • Use the navigation buttons ("Next Move" and "Previous Move") to move forward or backward through the game moves.

  4. Move Pieces on the Board:

    • Click on a piece and then click on its destination square to make a move on the chessboard.

  5. Reset the Board:

    • Click on the "Reset Board" button to reset the board to the initial state.

  6. Analysis Bar:

    • The vertical bar on the left side of the board dynamically shows the evaluation score from Stockfish, split to indicate advantage for white and black sides.

  7. Quit the Application:

    • Close the application window or press Ctrl+C in the terminal to exit.

Files Structure

Chess-Game-Analysis/
│
├── main.py                # Main application entry point
├── gui.py                 # GUI setup and interaction
├── engine.py              # Chess engine integration (Stockfish)
├── move_history.py        # Move history management
├── navigation.py          # Navigation buttons for moves
├── stockfish/             # Directory for Stockfish engine
│   └── stockfish.exe      # Stockfish executable (platform specific)
├── assets/                # Directory for chess piece images
│   └── piece_images/      # Directory containing piece images (wp.png, bp.png, etc.)
└── README.md              # Documentation file