A minimalist, real-time chess board perception engine & HUD for study and bot training.
Built with Chrome Extensions Manifest V3, WebAssembly Stockfish, and zero DOM injection.
- Isolated Side Panel HUD:
- Non-intrusive: Renders in Chrome's native Side Panel. Zero DOM modification or foreign elements on the target chessboard.
- Client-Side Stockfish Engine:
- Powered by Stockfish compiled to WebAssembly / asm.js. Runs entirely offline in an isolated Web Worker without blocking your browser UI.
- Real-Time Board Perception:
- Fast, event-driven DOM observer that maps chessboard states to standard FEN notation with millisecond latency.
- Supports both Chess.com and Lichess.org (Live matches, Daily games, Puzzles, and Analysis boards).
- Accurate Rules & Move Mechanics:
- Dynamic en-passant calculation and castling rights tracking via move history inspection.
- Puzzle & Clockless Mode Detection:
- Intelligently determines active turn on puzzles and analysis setups where digital clocks are absent.
- Continuous Dual-Side Analysis:
- Computes top engine recommendations regardless of whose turn it is (
White MovevsBlack Move), with clear role indicators ((Your Turn)vs(Opponent's Move)).
- Computes top engine recommendations regardless of whose turn it is (
- Perspective Lock & Auto-Detection:
- 3-way switcher (
AUTO,WHITE,BLACK) ensures manual color choices are never overwritten by board flipping.
- 3-way switcher (
- Engine Strength & Elo Throttling:
- Configurable Elo limits (1000 Elo Beginner to 3500 Elo Max) mapped to native Stockfish
Skill Level(0–20) and search depth limits.
- Configurable Elo limits (1000 Elo Beginner to 3500 Elo Max) mapped to native Stockfish
- Alternative Variations (MultiPV):
- Displays top 3 candidate moves along with evaluation and depth statistics.
- Clean Monochrome Aesthetic:
- High-contrast, dark terminal-inspired design without distracting neon effects or animations.
- Clone or Download this repository:
git clone https://github.com/emirgms-creator/KnightVision.git
- Open Google Chrome and navigate to:
chrome://extensions - Enable Developer mode using the toggle in the top-right corner.
- Click Load unpacked (top-left) and select the
KnightVisionproject directory (or extractKnightVision.zip). - Pin the KnightVision extension icon to your Chrome toolbar.
- Open a match, study board, or puzzle on Chess.com or Lichess.org.
- Click the KnightVision icon in your Chrome toolbar to open the HUD in your Side Panel.
- Choose your perspective: Leave on AUTO (automatically tracks board orientation) or click WHITE / BLACK to lock your perspective.
- As moves are made, KnightVision automatically tracks the board, computes the best move, and updates the evaluation bar.
KnightVision/
├── manifest.json # Chrome Manifest V3 configuration
├── icons/ # Extension icons (16px, 48px, 128px)
├── src/
│ ├── background/
│ │ └── service_worker.js # Side panel behavior manager
│ ├── content/
│ │ ├── board_parser.js # DOM-to-FEN converter for Chess.com & Lichess
│ │ └── content.js # MutationObserver event pipeline
│ ├── engine/
│ │ └── stockfish.js # WebAssembly/asm.js Stockfish engine
│ └── sidepanel/
│ ├── sidepanel.html # Minimalist HUD layout
│ ├── sidepanel.css # Monochrome styling
│ └── sidepanel.js # UCI protocol handler & UI renderer
KnightVision is intended strictly for educational purposes, study boards, analysis, and games against AI bots.
Online chess platforms (Chess.com, Lichess) strictly prohibit the use of chess engine assistance in rated multiplayer games against human opponents. Please respect platform fair-play rules.
KnightVision is privacy-first: all analysis runs 100% locally on your machine via WebAssembly Stockfish. Zero game data, personal data, or telemetry is ever collected, stored, or transmitted to any remote servers. See PRIVACY.md for the complete policy.
This project is open-source and available under the MIT License. The Stockfish chess engine is distributed under the GNU General Public License v3 (GPL-3.0).