Documentation

Guide d’utilisation de Grimoire

Trouvez des parties sur des sources publiques, importez-les dans vos propres bases, configurez un moteur UCI gratuit et exploitez les outils actuellement disponibles.

01

Installer et créer une première base

Grimoire s’installe sans base de parties ni moteur d’analyse. Vous choisissez séparément les sources qui alimentent vos bases et le moteur UCI utilisé pour l’analyse.

  • Lancez l’application et attendez la fin de l’initialisation locale.
  • Ouvrez Bases, choisissez Créer une base et donnez-lui un nom lié à son usage : tournoi, répertoire ou parties personnelles.
  • Ajoutez ensuite des parties avec un fichier PGN, une archive ou le connecteur Lichess Broadcast.
Bêta privée
02

Où récupérer des parties publiques

Grimoire importe des parties obtenues auprès de sources publiques. Vérifiez toujours les conditions d’utilisation de la source et conservez sa provenance avec votre base.

  • Lichess Broadcast : événements en direct et archives. Le connecteur intégré évite le téléchargement manuel.
  • The Week in Chess (TWIC) : recueils hebdomadaires téléchargeables en PGN compressé. L’import est manuel aujourd’hui ; un connecteur TWIC est prévu plus tard.
  • Base ouverte Lichess : archives mensuelles en PGN.ZST. Les archives de broadcasts sont adaptées à une base de tournoi ; les dumps complets de parties en ligne sont très volumineux.
  • Sites officiels de tournois : lorsqu’un organisateur publie un PGN ou un ZIP, téléchargez-le puis utilisez l’import de fichiers.
03

Importer un broadcast Lichess

Le connecteur public actuellement disponible récupère les parties terminées d’un événement Lichess et les ajoute à la base de votre choix.

  • Ouvrez Sources publiques et sélectionnez la base de destination en haut de l’écran.
  • Parcourez les événements à la une et les archives, recherchez un tournoi ou collez son URL Lichess Broadcast.
  • Sélectionnez un ou plusieurs événements, vérifiez la destination puis lancez l’import.
  • Relancez plus tard la récupération pour ajouter les nouvelles parties. Grimoire déduplique les parties déjà présentes.
  • Si nécessaire, l’annulation retire uniquement les parties ajoutées par cet import et protège celles que vous avez modifiées.
04

Importer un PGN ou une archive

Utilisez ce parcours pour TWIC, la base ouverte Lichess ou tout site de tournoi qui propose des fichiers téléchargeables.

  • Dans Bases, sélectionnez la destination puis choisissez Ajouter des parties.
  • Choisissez un ou plusieurs fichiers, un dossier complet, ou collez directement du texte PGN.
  • Formats actuels : PGN, PGN.GZ, PGN.ZST, ZIP, 7z et TAR.BZ2.
  • Suivez les compteurs de fichiers découverts, parties ajoutées, doublons et rejets. Un import interrompu peut être repris lorsqu’un point de reprise est disponible.
  • Pour une archive Lichess très volumineuse, créez une base dédiée et prévoyez suffisamment d’espace disque.
05

Synchroniser ses propres parties

La page Connecteurs complète les sources publiques avec la synchronisation de comptes de jeu Lichess et Chess.com vers la base Mes parties.

  • Créez un profil joueur pour regrouper les comptes qui représentent la même personne.
  • Ajoutez un compte Lichess ou Chess.com ; Lichess peut demander une autorisation OAuth dans le navigateur.
  • Lancez la synchronisation et consultez le bilan : parties découvertes, ajoutées, ignorées ou rejetées.
  • Ces connecteurs personnels sont distincts du catalogue Sources publiques consacré aux tournois.
06

Explorer les parties importées

Dans l’Explorateur, jouez des coups sur l’échiquier ou partez d’une position. L’arbre de coups, les statistiques et la liste des parties restent synchronisés.

  • Filtrez l’ensemble de la base par joueur, couleur, Elo, date, ouverture ou position.
  • Triez les résultats sur toute la base, pas seulement sur la page visible.
  • Ouvrez une partie directement au coup correspondant à la position explorée.
  • Enregistrez une nouvelle variante ou copiez une sélection filtrée vers une autre base.
07

Préparer un joueur

La recherche Joueurs construit une fiche à partir des parties contenues dans la base sélectionnée.

  • Recherchez un nom, puis ouvrez la fiche pour consulter résultats, Elo maximal et parties récentes.
  • Choisissez Arbre avec les Blancs ou Arbre avec les Noirs pour ouvrir un explorateur déjà filtré.
  • Changez de base active pour comparer un joueur dans des corpus différents.
08

Installer Stockfish sur macOS

Stockfish est un moteur d’échecs UCI gratuit, open source et indépendant de Grimoire. Sur un Mac Apple Silicon, Homebrew est le parcours le plus simple.

  • Si Homebrew est installé, ouvrez Terminal et exécutez : brew install stockfish.
  • Dans Grimoire, ouvrez Moteurs, cliquez Ajouter un moteur UCI et choisissez /opt/homebrew/bin/stockfish.
  • Sans Homebrew, téléchargez la version Apple Silicon sur le site officiel, décompressez-la dans un dossier stable puis sélectionnez l’exécutable Stockfish.
  • Grimoire vérifie l’identité et les options du moteur. Cliquez Activer si plusieurs moteurs sont configurés.
09

Installer Stockfish sur Windows

Stockfish ne nécessite pas d’installateur Windows : téléchargez l’archive officielle adaptée à votre processeur, puis conservez l’exécutable dans un dossier permanent.

  • Sur le site officiel, choisissez Windows x64 AVX2, recommandé pour la plupart des PC récents. Utilisez la version 64-bit générique si AVX2 n’est pas pris en charge.
  • Décompressez l’archive, par exemple dans C:\Tools\Stockfish, et ne déplacez plus ce dossier après la configuration.
  • Dans Grimoire, ouvrez Moteurs, cliquez Ajouter un moteur UCI et sélectionnez le fichier stockfish…exe.
  • Après validation, cliquez Activer. SmartScreen peut demander une confirmation lors du premier lancement du binaire téléchargé.
10

Analyser une partie

Une fois le moteur activé, ouvrez une partie et utilisez le panneau moteur pour analyser la position ou lancer une revue complète.

  • Réglez le nombre de variantes, la mémoire Hash et les threads selon les ressources de votre machine.
  • Les évaluations, profondeurs et meilleurs coups se mettent à jour sans modifier la notation.
  • La revue de partie parcourt les positions et met en évidence imprécisions, erreurs et gaffes à la profondeur choisie.
  • Les variantes et commentaires que vous ajoutez peuvent être enregistrés dans la partie.
11

Entretenir et exporter une base

Les outils de gestion servent à déplacer, fusionner, vérifier et sauvegarder les parties que vous avez collectées.

  • Exportez une base vérifiée en PGN, PGN compressé Zstandard ou archive ZIP.
  • Prévisualisez une fusion avant de l’exécuter et archivez éventuellement la base source.
  • Optimisez une base pour compacter ses fichiers et ses index sans changer les parties ni leur provenance.
  • La réinitialisation revient à la dernière version publiée de la base et annule les changements locaux ultérieurs.