v1.2.0

ChessCheater HEHEHEHEHE v1.2.0 - Auto-Play Edition!

This is a major update to the Chess.com AI Helper, now cheekily named "ChessCheater HEHEHEHEHE"! This version introduces auto-play functionality for Bullet and Blitz games, a keyboard failsafe, and other enhancements.

Building on v1.0.0 which included:

• Automatic browser opening (chess.com) and login.
• Real-time game move scraping.
• Internal board state calculation and FEN generation.
• Integration with the Ethereal-9.00 engine (or other UCI engines) for move suggestions.
• User-friendly GUI with primary output and detailed debug logs.

New in v1.2.0:

• ✨ Auto-Play Modes: Dedicated "Play Bullet" and "Play Blitz" buttons to have the bot automatically make moves for you on chess.com!
  • Uses pyautogui for on-screen mouse control.
  • Dynamic "human-like" move delays that vary based on game mode and (attempted) remaining clock time. (Blitz mode has significantly longer non-urgent delays, configurable in auto_player.py).
• 🛡️ Keyboard Failsafe: Press the ESC key at any time during auto-play to immediately stop the bot's actions.
• 🔄 Board Orientation Detection: The application now attempts to detect if your board on chess.com is flipped (e.g., when playing as Black and Black's pieces are at the bottom of your screen) for more accurate mouse control during auto-play.
• 🛠️ One-Folder Release: Packaged as a one-folder application, making it easy to access and modify the .env file for your credentials and see the bundled engine.
• ⚙️ Configurable Screen Coordinates: For auto-play to work, users running from source can (and must) configure BOARD_OFFSET_X, BOARD_OFFSET_Y, and SQUARE_PIXEL_SIZE in src/config.py to match their screen setup. Note: Packaged releases use default values set at build time.
• 🐞 Various Bug Fixes and Stability Improvements related to board state updates and engine communication.

How to Install & Use (One-Folder Release for Windows):

1. Download ChessCheater_HEHEHEHEHE-v1.2.0-windows.zip from the Assets section below.
2. Extract the ZIP file to a new folder on your computer. This will create a folder named ChessCheater HEHEHEHEHE.
3. Navigate into the extracted ChessCheater HEHEHEHEHE folder.
4. Crucial: Open the .env file (located next to ChessCheater HEHEHEHEHE.exe) with a text editor.
5. Add your chess.com credentials:

   CHESS_USERNAME="YOUR_CHESS.COM_USERNAME"
   CHESS_PASSWORD="YOUR_CHESS.COM_PASSWORD"

   Replace the placeholders with your actual username and password. Save the file.
6. Ensure you have Google Chrome installed.
7. Run ChessCheater HEHEHEHEHE.exe from within this folder.
8. For detailed instructions on configuring screen coordinates (if the defaults don't work for auto-play and you decide to build from source), usage, and other features, please refer to the main README.md.

Disclaimer:
This tool is intended for educational purposes, analysis, and playing against computer opponents. Using this tool to cheat in rated games on chess.com or any other platform is against their terms of service and can lead to account suspension. Please use responsibly and ethically.

Note: The bundled Ethereal-9.00 engine is compiled for Windows.

v1.0.0 - Initial Release

This is the first release of the Chess.com AI Helper!

Features:

• Opens chess.com and logs in automatically.
• Scrapes moves from ongoing games.
• Calculates FEN and board state.
• Integrates with Ethereal-9.00 engine for move suggestions.
• GUI with user output and debug logs.

How to Use:

1. Download the ChessAIHelper-v1.0.0-windows.zip file below.
2. Extract the ZIP file to a folder on your computer.
3. Important: Inside the extracted ChessAIHelper folder, create a new file named .env.
4. Open the .env file with a text editor and add your chess.com credentials like this:

   CHESS_USERNAME="YOUR_CHESS.COM_USERNAME"
   CHESS_PASSWORD="YOUR_CHESS.COM_PASSWORD"
   

   Replace the placeholder text with your actual username and password.
5. Ensure you have Google Chrome installed.
6. Run ChessAIHelper.exe.

Note: The Ethereal-9.00 engine included is compiled for Windows.