^{Chess Grandmaster}

Chess Grandmaster is a browser extension designed to enhance your online chess experience on platforms like Chess.com and Lichess.org. It offers real-time analysis, a customizable bot player, and visual aids to help you learn and improve.

---

• Features
• Installation
  • GitHub Releases (Recommended)
  • Marketplace (Limited Edition)
  • Building from Source
• Contributing
• License

✨ Features

• AI Analysis: Get real-time Stockfish 17 analysis with move suggestions.
• Bot Player: Play against a customizable AI with human-like behavior, adjustable ELO/Strength, and "Humanizer" heuristics.
• Visual Aids: In-game evaluation bar, best move arrows, and threat indicators.
• Stealth Mode: DOM-injection techniques designed to be unobtrusive.
• Customizable: Fine-tune engine depth, multi-pv lines, and play speed.

📥 Installation

There are three ways to install Chess Grandmaster. We recommend using GitHub Releases for the full, unlocked experience.

Option 1: GitHub Releases (Recommended)

This version contains all features, including Auto-Move and full engine strength.

1. Go to the Releases Page.
2. Download the .zip file for your browser (grandmaster-chrome-vX.X.zip or grandmaster-firefox-vX.X.zip).
3. Unzip the downloaded file into a folder.

For Chrome / Edge / Brave:

1. Navigate to chrome://extensions/.
2. Toggle Developer mode in the top right corner.
3. Click Load unpacked.
4. Select the folder where you extracted the files.

For Firefox:

1. Navigate to about:debugging#/runtime/this-firefox.
2. Click Load Temporary Add-on....
3. Navigate to the extracted folder and select the manifest.json file.

Option 2: Marketplace (Limited Edition)

The "Chess Coach" edition is available on official extension stores. To comply with store policies, Auto-Move and certain automation features are disabled in this version. It is strictly for analysis and learning.

• Chrome Web Store (Link pending)
• Firefox Add-ons (Link pending)

Option 3: Building from Source

If you are a developer or want to modify the code, you can build the extension yourself.

Prerequisites

• Node.js (Version 20 or higher)
• pnpm (npm install -g pnpm)

Build Steps

1. Clone the repository:

   git clone https://github.com/shahradelahi/chess-grandmaster-extension.git
   cd chess-grandmaster-extension

2. Install dependencies:

   pnpm install

3. Build the extension:

   • For Firefox:

     pnpm build

   • For Chrome:

     pnpm build:chrome

4. Load the extension:

   • The compiled files will be in the dist/ directory.
   • Follow the loading instructions in Option 1 using the dist folder.

🤝 Contributing

Want to contribute? Awesome! To show your support is to star the project, or to raise issues on GitHub.

Thanks again for your support, it is much appreciated! 🙏

License

GPL-3.0 © Shahrad Elahi and contributors.