Pétanque Turnier-Manager

Turnierleitungssoftware für LibreOffice Calc

View project on GitHub

Logo

Gestionnaire de tournois de Pétanque

CI License: EUPL v1.2 Wiki Faire un don avec PayPal

*Read this in other languages: 🇩🇪 DE 🇬🇧 EN 🇫🇷 FR 🇪🇸 ES 🇳🇱 NL*

Built with the precision of a software engineer and the passion of a pétanque player.

🎯 Introduction

Le Gestionnaire de tournois de Pétanque (Pétanque-Turnier-Manager) est un logiciel open-source performant pour la gestion de tournois, qui s’intègre parfaitement comme extension dans LibreOffice Calc.

Ce logiciel a été spécialement conçu pour rendre l’organisation et le déroulement des tournois de pétanque et de boules aussi simples et efficaces que possible. Comme il fonctionne de manière totalement hors ligne et directement dans le tableur, il consomme très peu de ressources. Cela en fait la solution idéale pour une utilisation sur le terrain de boules – même sur d’anciens ordinateurs portables fonctionnant, par exemple, sous un système Linux léger.

Les avantages en un coup d’œil :

  • Indépendant du système d’exploitation : Fonctionne de manière fiable sous Linux, macOS et Windows.
  • Multilingue : L’interface utilisateur prend en charge plusieurs langues, dont l’allemand (DE), l’anglais (EN), le français (FR), l’espagnol (ES) et le néerlandais (NL).
  • Gratuit & Open Source : Pas de frais de licence, pas de publicité.
  • Économe en ressources : Parfaitement adapté au matériel plus ancien.
  • Tout en un seul endroit : Aucune base de données externe n’est nécessaire ; tout est calculé et enregistré directement dans LibreOffice Calc.
  • Base de joueurs intégrée : Gérez joueurs et clubs de manière centralisée et reprenez-les directement dans la liste d’inscription via la recherche/filtre – avec import/export et un visualiseur web intégré.
  • Serveur web intégré : Affichez toutes les données du tournoi en direct sur un téléviseur, une tablette ou un smartphone – directement depuis LibreOffice, sans logiciel externe.
  • Page d’accueil du tournoi : Page de bienvenue entièrement configurable pour vidéoprojecteur ou téléviseur, avec logo, image de fond, animations, compteurs en direct et barre de statut – idéale pour la table d’inscription le jour du tournoi.
Available in Languages: 🇩🇪 DE 🇬🇧 EN 🇫🇷 FR 🇪🇸 ES 🇳🇱 NL

🛠️ Personnalisation sans limites : Faites-en votre tournoi !

Le plus grand atout de ce gestionnaire de tournoi est sans doute sa base : LibreOffice Calc. Comme toutes les données, tableaux et classements sont écrits directement dans des feuilles de calcul Calc ordinaires, vous n’êtes pas enfermé dans une structure de programme rigide.

💡 Contrôle total avec les outils intégrés de Calc : Vous pouvez étendre n’importe quel système de tournoi généré de manière totalement libre et selon vos propres souhaits !

  • Tournois internationaux : Grâce au support multilingue intégré, vous êtes parfaitement équipé pour les tournois avec des invités internationaux ou pour les ligues transfrontalières.
  • Évaluations personnalisées : Utilisez RECHERCHEV, des tableaux croisés dynamiques ou vos propres formules pour extraire des statistiques internes aux équipes, des moyennes de points ou des classements spéciaux à partir des données du tournoi.
  • Personnalisation visuelle : Créez vos propres tableaux de bord, insérez les logos du club, modifiez la mise en page pour l’impression ou concevez des vues de présentation pour un vidéoprojecteur (par ex. pour l’affichage en direct du classement actuel).
  • Macros personnalisées & API publique : Si vous avez besoin de fonctions avancées, vous pouvez écrire vos propres macros LibreOffice (Basic, Python, etc.) qui interagissent avec les tableaux générés. L’extension fournit une API publique pour cela. → Macros & Formules – documentation complète de l’API (en allemand)

L’extension s’occupe de la logique complexe (tirage au sort, calcul du classement selon le système Buchholz, etc.) – ce que vous faites des données à la fin dépend entièrement de vous !

🏆 Systèmes de tournoi pris en charge

L’extension propose déjà un large choix de modes de tournoi éprouvés, adaptés aux petits championnats de clubs comme aux grands tournois :

  • Supermêlée / Mêlée : Idéal pour les tournois décontractés. Les joueurs sont tirés au sort dans de nouvelles équipes et contre de nouveaux adversaires à chaque tour (ou pour tout le tournoi).
  • Ligue (Championnat) : Pour l’organisation d’une ligue de club ou régionale avec des équipes fixes. Le calendrier des matchs est généré à l’avance et détermine qui joue contre qui et quand. Le classement est calculé selon les victoires, la différence de boules et la confrontation directe. Prend en charge l’exportation HTML des résultats et du calendrier.
  • Système Suisse (Formule Suisse) : Le système le plus équitable pour les tournois avec de nombreux participants et un temps limité. Comprend le calcul automatique des victoires, de la différence de boules et des points Buchholz (et Buchholz médian) pour un classement exact.
  • Toutes rondes (Round Robin) : Le système de ligue classique où chaque équipe affronte toutes les autres équipes au cours du tournoi.
  • Élimination directe (Système à élimination directe) : Pour les phases finales classiques et les tournois à élimination directe pure. Une victoire signifie la qualification, une défaite l’élimination immédiate. Les appariements suivent le système croisé (1er vs Dernier, 2e vs Avant-dernier …), de sorte que les meilleures équipes ne se rencontrent que tardivement. Pour les nombres de participants qui ne sont pas une puissance de deux, une phase de cadrage (tour préliminaire) est automatiquement calculée.
  • Système de Maastricht : Combine le Système Suisse avec des phases finales à élimination directe. Les équipes sont appariées selon l’algorithme suisse sur plusieurs tours préliminaires (2–5). Ensuite, les équipes sont réparties en groupes de niveau (A, B, C, D) selon leur nombre de victoires – chaque groupe dispute sa propre finale en élimination directe. Résultat : quatre vainqueurs de tournoi, une répartition équitable et des finales palpitantes.
  • Système Poule A/B : Mode classique avec phase de groupes (Poules) selon le principe de la double élimination légère, suivi d’une répartition en Concours A (tableau principal) et Concours B (consolante).
  • Système KO en cascade (Système ABCD étendu) : Étend le système KO classique ABCD avec autant de niveaux supplémentaires que souhaité (E, F, G, H …). Au lieu d’être éliminées tôt, les équipes perdantes sont cascadées progressivement vers des consolantes de niveau inférieur. Après un nombre minimum de tours configurable, chaque niveau bascule en élimination directe – avec un cadrage propre si nécessaire. Adapté aux tournois de taille moyenne à grande (dès 16 équipes).
  • Formule X : Système de ronde moderne issu du pétanque français – idéal pour les grands plateaux et les tournois à durée limitée. Toutes les équipes jouent le même nombre de rondes, personne n’est éliminé. Le classement repose sur un score cumulé clair (bonus victoire + points propres + différence de points) – sans Buchholz. La 1re ronde est tirée au sort ; à partir de la 2e, les appariements suivent le classement : 1er vs 2e, 3e vs 4e, etc.
  • Trip-Tête / Système Trio : Format par équipes de trois joueurs dans lequel chaque rencontre comprend une Triplette, une Doublette et un Tête-à-tête. Après la Triplette commune, l’équipe se répartit tactiquement : deux joueurs disputent la Doublette, un joueur dispute le Tête-à-tête. Adapté aux tournois par équipes compacts, variés et avec une notation claire des rencontres.

👥 Base de joueurs intégrée – saisir une fois, réutiliser indéfiniment

Plutôt que de retaper la liste des participants à chaque tournoi, le Pétanque Tournament Manager intègre une base de joueurs directement dans l’extension. Joueurs, clubs et étiquettes sont saisis une seule fois et restent disponibles pour chaque nouveau tournoi.

  • 🧑‍🤝‍🧑 Gestion centralisée des joueurs et clubs – prénom, nom, club, numéro de licence et étiquettes libres (par ex. « Féminines », « Jeunes », « Club d’origine »).
  • 🔍 Recherche & filtres rapides – recherche dès 2 caractères, combinable avec les filtres par club et par étiquette.
  • ➕ Reprise directe dans la liste d’inscription – un double-clic ajoute un joueur ; plusieurs joueurs peuvent être regroupés en équipe et écrits ensemble dans la liste. Les joueurs déjà inscrits peuvent être masqués pour éviter les doublons.
  • 📥 Import / Export – format CSV et format de fichier DB propre. Partagez l’effectif du club entre tournois ou importez des listes existantes.
  • 🌐 Visualiseur web intégré – un frontend en lecture seule pour la base de joueurs, idéal pour la table d’inscription ou le bureau du tournoi.

💡 Pratique pour les tournois de club : Saisissez une fois tous les membres actifs – dès le tournoi suivant, il suffit de taper les premières lettres du nom pour ajouter le joueur à la liste avec son club et son numéro de licence.

🌐 Serveur web intégré – Affichage en direct le jour du tournoi

Le Pétanque Tournament Manager dispose d’un serveur web entièrement intégré – directement depuis LibreOffice Calc, sans logiciel externe ni connexion internet.

Pendant le déroulement du tournoi, toutes les feuilles peuvent être affichées dans un navigateur sur téléviseur, ordinateur portable, tablette ou smartphone – en temps réel, mis à jour automatiquement :

  • 📋 Listes des participants – qui joue ?
  • 🎯 Ronde en cours – quels matchs sont en cours ?
  • 🏆 Classements – mis à jour en direct après chaque ronde
  • 📊 Tableaux personnalisés – publiez n’importe quelle feuille Calc

💡 Aussi simple que ça : Démarrez le serveur web depuis le menu → ouvrez l’URL dans un navigateur → c’est tout. Tous les appareils sur le même réseau Wi-Fi voient les données du tournoi en direct.

Détails techniques :

  • Interface React avec Server-Sent Events (SSE) – mises à jour instantanées sans rechargement de page
  • Jusqu’à 10 URLs simultanées configurables
  • Zoom, centrage et en-têtes/pieds de page configurables par port
  • Tous les systèmes de tournoi pris en charge : Supermêlée, Système suisse, Chacun contre chacun, K.-O., Système maastrichtois, Formule X, Trip-Tête

🎬 Page d’accueil du tournoi – la page de bienvenue pour le jour J

En plus des tableaux de données, le serveur web intégré propose sa propre page d’accueil du tournoi, que vous pouvez montrer au public à la table d’inscription, sur le vidéoprojecteur ou sur le téléviseur du club. Elle se configure via son propre dialogue et ne nécessite aucun logiciel externe.

  • 🖼️ Logo & arrière-plan : Logo du club, image de fond et image de pied de page personnalisées, couleurs de fond et de texte au choix (sélecteur de couleur natif LibreOffice).
  • ✍️ Description multi-lignes du tournoi : Nom du tournoi, accroche et texte descriptif avec animation fondu, glissement ou machine à écrire en boucle infinie.
  • 🔢 Compteurs en direct : « Inscrits » et « Actifs » défilent dans des cartes animées – directement depuis la liste d’inscription.
  • 🧭 Barre de statut : Système de tournoi actuel, progression et phrases rotatives.
  • 🔍 Zoom 10–500 % : Mise en page adaptable à toute taille d’écran, l’image de fond reste non mise à l’échelle.

💡 Mise en place rapide : Ouvrir le dialogue de configuration dans le menu PétTurnMngr → choisir un logo, saisir la description → démarrer le serveur web → ouvrir l’URL sur le vidéoprojecteur ou le téléviseur.

💻 Prérequis système

  • LibreOffice : à partir de la version 25.x (ou plus récente)
  • Java (JRE/JDK) : à partir de la version 25
  • Système d’exploitation : Linux, Windows ou macOS 11 (Big Sur) ou plus récent

⚙️ Installation & Configuration

Recommandé : installation avec l’installateur

Téléchargez le paquet d’installation adapté depuis les GitHub Releases :

Remarque (macOS) : Nécessite macOS 11 (Big Sur) ou plus récent. macOS 10.15 (Catalina) et antérieurs ne sont pas pris en charge (runtime Java 25).

Lancez l’installateur et suivez les instructions. L’installateur configure l’extension pour LibreOffice.

Alternative : installation manuelle

Étape 1 : Installer Java

Étape 2 : Activer Java dans LibreOffice

  1. Ouvrez LibreOffice. Allez dans Outils ▸ Options ▸ LibreOffice ▸ Avancé. (Sur macOS : LibreOffice ▸ Préférences...)
  2. Cochez la case “Utiliser un environnement d’exécution Java”.
  3. Sélectionnez le JRE installé dans la liste. Validez avec OK et redémarrez LibreOffice.

Étape 3 : Installer l’extension

  1. Téléchargez la dernière version de l’extension (PetanqueTurnierManager-vx.xx.oxt) dans la section Releases.
  2. Double-cliquez sur le fichier .oxt. LibreOffice ouvrira le Gestionnaire des extensions.
  3. Confirmez l’installation.

🚀 Premiers pas & Utilisation

  1. Démarrez LibreOffice Calc et ouvrez un nouveau classeur vide.
  2. Dans la barre de menu supérieure, vous trouverez un nouveau menu appelé “PétTurnMngr”.
  3. Cliquez dessus. Le centre de contrôle s’ouvre : vous pouvez ajouter des joueurs, choisir le mode et générer les tours.
  4. Saisissez simplement les résultats des parties dans les champs générés ; les tableaux et les tours suivants se calculent automatiquement.

📖 Documentation & Aide

La documentation complète se trouve sur notre Wiki officiel (actuellement en allemand) : 👉 Accéder au Wiki du projet ici

Licence : Ce projet est sous Licence EUPL-1.2.