Extension Chrome · Open source

CarlsenChess

CarlsenChess rend l'analyse échiquéenne visible directement dans le navigateur. L'extension relie Stockfish, exécuté localement en WebAssembly, à un plateau d'échecs et indique le coup proposé par une flèche. Son panneau rassemble l'évaluation, les réglages de force et les options d'analyse.

Gratuit · v1.4.0 · ZIP d'environ 76 Mo · Chrome 116 ou ultérieur · installation manuelle

Icône de l'extension CarlsenChess

Stockfish 19 · WebAssembly · Manifest V3

Votre prochain coup, directement sur le plateau

Aperçu

Une flèche claire, un panneau compact.

Interface réelle de CarlsenChess sur la démonstration locale : panneau de réglages à droite, coup Qa8# proposé et flèche de la dame de f3 vers a8 sur le plateau.(ouvrir en taille réelle)
Interface réelle de l'extension, sur la démonstration locale incluse dans les sources.

6

paliers Elo indicatifs de 500 à 3000, plus la puissance maximale

0

service distant ou clé API nécessaire pour l'analyse

4

permissions Chrome, sans accès permanent à tous les sites

0,9–10 s

de réaction cible en jeu automatique, calcul inclus

Le coup, sur le plateau

Une flèche relie la pièce à déplacer à sa case d'arrivée. Le panneau affiche le coup en notation, l'évaluation et la profondeur d'analyse, et se met à jour quand la position change.

Une force réglable

Paliers de 500, 1000, 1500, 2000, 2500 et 3000 Elo indicatifs, ou puissance maximale. Les profils 500 et 1000 sont simulés : ce ne sont pas des classements humains mesurés.

Humaniser les choix

Une option fait varier la proposition parmi les coups candidats admissibles, indépendamment du réglage de force du moteur.

Analyse sur l'appareil

Stockfish 19 tourne en WebAssembly dans un Worker local. Aucune clé API ni service distant pour l'analyse, et des réglages conservés localement.

Jeu automatique optionnel

Sur l'adaptateur Chess.com, après activation explicite : choix des Blancs ou des Noirs, attente du tour adverse et promotions prises en charge. La pause annule toute action en attente.

Réaction selon la difficulté

L'attente s'adapte à une estimation de la complexité de la position, avec une cible de 0,9 à 10 secondes calcul inclus. Une estimation, pas une mesure de difficulté humaine.

Architecture

Un moteur local, relié au plateau en continu.

Un clic sur l'icône injecte le panneau dans l'onglet courant. L'adaptateur lit la position au format FEN et la compare aux pièces visibles, puis le service worker la transmet à un document offscreen où Stockfish calcule dans un Worker. La réponse du moteur, reçue en UCI, est validée avant d'apparaître sous forme de flèche. Chaque analyse reste liée à sa position : si la partie avance pendant le calcul, le résultat est écarté et une nouvelle analyse démarre.

Côté page

  • Panneau injecté dans un Shadow DOM, isolé du style de la page.
  • Flèche et cases en SVG, recalées sur le plateau par l'observation du DOM et de ses dimensions.
  • Adaptateur Chess.com : lecture de la FEN dans le contexte MAIN, interface dans le contexte ISOLATED.
  • Connexion générique à un jeu exposant une FEN complète, ou saisie manuelle d'une FEN.
  • Démonstration locale jouable incluse dans les sources.

Côté extension

  • Service worker Manifest V3 : activation par l'icône et relais des analyses.
  • Document offscreen qui héberge Stockfish.js 19.0.1, variante complète à un seul thread.
  • Dialogue avec le moteur en UCI, coups validés avec chess.js 1.4.0.
  • Permissions limitées à activeTab, scripting, storage et offscreen.
  • Réglages enregistrés localement, sauf l'activation du jeu automatique.

Adaptateur Chess.com

Vérifié sur des plateaux de test locaux.

Ces plateaux reproduisent les contrats utilisés par l'adaptateur Chess.com : classes des pièces, lecture de la position et orientation. Ils servent aux tests avec le vrai moteur Stockfish ; ce ne sont pas des parties jouées en ligne.

Panneau CarlsenChess et flèche du coup proposé sur un plateau de test local reproduisant le contrat de l'adaptateur Chess.com.(ouvrir en taille réelle)
Le plateau suivi automatiquementL'adaptateur relit la position complète après chaque coup. Capture sur un plateau de test local.
Panneau CarlsenChess avec le jeu automatique activé, le choix des Blancs et le réglage du temps de réaction, sur un plateau de test local.(ouvrir en taille réelle)
Les réglages du jeu automatiqueCamp joué, jeu automatique optionnel, réaction selon la difficulté et pause. Capture sur un plateau de test local.

Défis techniques

  • Rejet des résultats devenus périmés : une analyse qui arrive après un changement de position est ignorée.
  • Lecture d'une position fraîche à la fin du calcul et avant chaque action, même après un réveil de minuteur tardif.
  • Chaque coup automatique est lié au plateau, à sa FEN, à la couleur choisie et à une autorisation limitée à cette demande.
  • Suspension sur la position courante si une entrée n'est pas confirmée, pour ne jamais répéter les clics.
  • Annulation des actions en attente à la pause ou au moindre changement de position ou de réglage.

Ma contribution

Conception et développement de bout en bout : interface, intégration Stockfish, adaptateurs de plateau, automatisation optionnelle, tests et distribution.

Conception de l'expérience et du panneau de réglages
Intégration de Stockfish dans une extension Chrome
Guidage visuel superposé au plateau
Liaison entre état du jeu, analyse et interface
Adaptateur Chess.com et contextes MAIN / ISOLATED
Tests, packaging et distribution sur GitHub

Tests et limites

Les tests Node.js, écrits avec node:test et jsdom, tournent en intégration continue sur GitHub Actions. Les tests navigateur, avec Playwright et Chromium, se lancent localement et utilisent de vrais calculs Stockfish sur des plateaux locaux.

  • Les valeurs Elo sont indicatives et ne correspondent pas à des classements humains garantis.
  • Le jeu automatique est vérifié sur des plateaux de test locaux ; un parcours complet face à un adversaire réel sur Chess.com reste à valider.
  • Chrome peut ralentir ou suspendre un onglet : le fonctionnement n'est pas garanti sur une page suspendue, fermée ou un ordinateur en veille.
  • Un rechargement de la page demande de réactiver le jeu automatique.

Installation

Prêt en quatre étapes.

  1. 1Télécharger le ZIP de l'extension, puis le décompresser.
  2. 2Ouvrir chrome://extensions et activer le mode développeur.
  3. 3Cliquer sur « Charger l'extension non empaquetée » et choisir le dossier qui contient manifest.json.
  4. 4Épingler l'extension, ouvrir un plateau, cliquer sur son icône puis sur « Démarrer ».

Google Chrome 116 ou ultérieur. Le ZIP contient déjà le moteur et les fichiers de l'extension.

Stack technique

JavaScript (modules ES)HTML / CSSManifest V3Chrome APIOffscreen documentWeb WorkersWebAssemblyStockfish.js 19.0.1chess.js 1.4.0UCIFENShadow DOMSVGMutationObserverResizeObserverNode.jsnode:testjsdomPlaywrightGitHub Actions

CarlsenChess — © 2026 Thomas Marsa, distribué sous licence GPL-3.0-only. Stockfish et chess.js sont des composants tiers qui conservent leurs auteurs et leurs licences. Projet indépendant, sans affiliation avec Chess.com ni avec Magnus Carlsen.