SportScoreboard › DocumentatieDocumentationDocumentation
0. Introduction
What SportScoreboard does
An operator scores a match: goals, points, the clock, cards, substitutions, time penalties. A big screen shows the score to the public. For a tournament, an organizer runs many courts at once, starts them together, sees every score on one screen and prints the results at the end.
It is made for clubs and school events, so it runs on what you already have: a Windows laptop, the phones of the volunteers and any TV or projector with a web browser. No internet, no account, no subscription.

The parts
| Part | What it is | Who uses it |
|---|---|---|
Desktop app (SportScoreboard.exe) | A Windows program: sport picker, team and referee lists, single matches, launcher for everything else | The person at the laptop |
| Scoreboard Engine | A small server that runs in the background on the laptop. It keeps every match, and phones and screens connect to it | Nobody sees it; the desktop app starts it |
| Start, Schedule, Today, Prepare (web pages) | The pages of the engine: quick matches, the schedule, running the day (master controller, screens, reports) and the planner | The organizer, in a browser |
| Controller (operator page) | A web page for scoring one match, made for a phone | The operator at the court |
| Big screen | A web page that shows one match, big | A TV, projector or phone |
| Overview | A web page that shows every court on one screen | A TV in the cafeteria |
You do not have to use all of them. A single match needs only the desktop app. A tournament uses the web pages (Prepare, Schedule, Today), one controller per court and, if you like, a big screen per court plus the overview.
Key ideas
Court. One match in progress, with its own links: a link for the operator, a link for the big screen and an 8-character join code. A tournament has one court per field, hall or table. When a match ends you start the next one on the same court.
Link and code. Whoever has the operator link can score that court. Whoever has the big-screen link can only watch. The links contain a secret, so hand them out only to the people of that court. If a QR code does not scan, type the join code at /join.html.
Organizer key. A short secret printed when the engine starts and shown in the desktop app. It unlocks the organizer page. Do not hand it out.
Official and casual matches. In a casual match you only count the score. In an official match you also have real rosters, shirt numbers, cards and substitutions, and the program checks them. You choose per tournament, or per match.
Sport and board. Each sport has its own rules. Sports that work alike share one kind of scoreboard:
- team sports with a clock (football, handball, basketball, hockey, rugby, martial arts, ...),
- games and sets without a clock (volleyball, badminton, table tennis, squash, padel, tennis),
- darts.
See the sports guide for each sport.
Everything is kept. After every action the match is saved. If the program, the laptop or the phone fails, open the match again and carry on. Every action can be undone, one step at a time.
How a tournament day goes
- Start the desktop app. It starts the engine and shows the organizer key.
- In Prepare: choose the sport(s), create the pools, add the teams, make the fields.
- Open the sharing dialog of each court and give the operator link (QR) to the volunteer at that court.
- Put the overview on the cafeteria TV and the big screen links on the court screens.
- Press Start all courts at the horn. Operators score; the scores appear on the screens.
- Press Start next match on a court when the next teams are ready.
- At the end, open the report and save it as PDF or Excel, then reset the courts for the next round.
Chapter 1 walks through this with the exact buttons.
0. Inleiding
Wat SportScoreboard doet
Een operator telt een wedstrijd: doelpunten, punten, de klok, kaarten, wissels, tijdstraffen. Een groot scherm toont de score aan het publiek. Voor een toernooi laat een organisator veel velden tegelijk draaien, start ze samen, ziet elke score op één scherm en drukt op het einde de uitslagen af.
Het is gemaakt voor clubs en schoolevenementen, dus het werkt met wat je al hebt: een Windows-laptop, de gsm's van de vrijwilligers en elke tv of beamer met een webbrowser. Geen internet, geen account, geen abonnement.

De onderdelen
| Onderdeel | Wat het is | Wie het gebruikt |
|---|---|---|
Desktop-app (SportScoreboard.exe) | Een Windows-programma: sportkeuze, team- en scheidsrechterlijsten, losse wedstrijden, startpunt voor al de rest | De persoon aan de laptop |
| Scoreboard Engine | Een kleine server die op de achtergrond op de laptop draait. Ze bewaart elke wedstrijd, en gsm's en schermen verbinden ermee | Niemand ziet ze; de desktop-app start ze |
| Start, Schema, Vandaag, Voorbereiden (webpagina's) | De pagina's van de engine: snelle wedstrijden, het schema, de dag leiden (hoofdbediening, schermen, verslagen) en de planner | De organisator, in een browser |
| Controller (bedieningspagina) | Een webpagina om één wedstrijd te tellen, gemaakt voor een gsm | De operator aan het veld |
| Groot scherm | Een webpagina die één wedstrijd groot toont | Een tv, beamer of gsm |
| Overzicht | Een webpagina die alle velden op één scherm toont | Een tv in de kantine |
Je moet ze niet allemaal gebruiken. Voor één wedstrijd heb je enkel de desktop-app nodig. Een toernooi gebruikt de webpagina's (Voorbereiden, Schema, Vandaag), één controller per veld en, als je wilt, een groot scherm per veld plus het overzicht.
Belangrijke begrippen
Veld. Eén wedstrijd die bezig is, met eigen links: een link voor de operator, een link voor het grote scherm en een code van 8 tekens om deel te nemen. Een toernooi heeft één veld per terrein, zaal of tafel. Als een wedstrijd afgelopen is, start je de volgende op hetzelfde veld.
Link en code. Wie de operatorlink heeft, kan dat veld tellen. Wie de link van het grote scherm heeft, kan enkel kijken. De links bevatten een geheim, dus deel ze alleen uit aan de mensen van dat veld. Als een QR-code niet wil scannen, typ je de code in op /join.html.
Organisatorsleutel. Een korte geheime sleutel die wordt getoond wanneer de engine start en in de desktop-app staat. Ze ontgrendelt de pagina van de organisator. Geef ze niet door.
Officiële en casual wedstrijden. In een casual wedstrijd tel je enkel de score. In een officiële wedstrijd heb je ook echte selecties, rugnummers, kaarten en wissels, en het programma controleert ze. Je kiest per toernooi, of per wedstrijd.
Sport en bord. Elke sport heeft eigen regels. Sporten die op elkaar lijken delen één soort scorebord:
- teamsporten met een klok (voetbal, handbal, basketbal, hockey, rugby, vechtsporten, ...),
- spelen en sets zonder klok (volleybal, badminton, tafeltennis, squash, padel, tennis),
- darts.
Zie de sportgids voor elke sport.
Alles wordt bewaard. Na elke actie wordt de wedstrijd opgeslagen. Als het programma, de laptop of de gsm uitvalt, open je de wedstrijd opnieuw en ga je verder. Elke actie kan ongedaan gemaakt worden, stap voor stap.
Hoe een toernooidag verloopt
- Start de desktop-app. Ze start de engine en toont de organisatorsleutel.
- In Voorbereiden: kies de sport(en), maak de poules, voeg de teams toe, maak de velden.
- Open het deeldialoogvenster van elk veld en geef de operatorlink (QR) aan de vrijwilliger bij dat veld.
- Zet het overzicht op de tv in de kantine en de links van de grote schermen op de schermen bij de velden.
- Druk op Alle velden starten bij het signaal. De operators tellen; de scores verschijnen op de schermen.
- Druk op Volgende wedstrijd starten bij een veld als de volgende teams klaar zijn.
- Open op het einde het verslag en sla het op als pdf of Excel, en reset daarna de velden voor de volgende ronde.
Hoofdstuk 1 loopt dit door met de exacte knoppen.
0. Introduction
Ce que fait SportScoreboard
Un opérateur encode un match : buts, points, chrono, cartons, remplacements, exclusions temporaires. Un grand écran montre le score au public. Pour un tournoi, un organisateur fait tourner plusieurs terrains à la fois, les démarre ensemble, voit chaque score sur un seul écran et imprime les résultats à la fin.
Le programme est conçu pour les clubs et les événements scolaires : il fonctionne avec ce que vous avez déjà, c'est-à-dire un ordinateur portable Windows, les téléphones des bénévoles et n'importe quelle TV ou n'importe quel projecteur équipé d'un navigateur web. Pas d'internet, pas de compte, pas d'abonnement.

Les différentes parties
| Partie | Ce que c'est | Qui l'utilise |
|---|---|---|
Application de bureau (SportScoreboard.exe) | Un programme Windows : choix du sport, listes d'équipes et d'arbitres, matchs isolés, lanceur pour tout le reste | La personne devant l'ordinateur portable |
| Scoreboard Engine | Un petit serveur qui tourne en arrière-plan sur l'ordinateur portable. Il garde tous les matchs, et les téléphones et les écrans s'y connectent | Personne ne le voit ; l'application de bureau le démarre |
| Accueil, Programme, Aujourd'hui, Préparer (pages web) | Les pages du moteur : matchs rapides, le programme, conduire la journée (contrôleur principal, écrans, rapports) et le planificateur | L'organisateur, dans un navigateur |
| Contrôleur (page de l'opérateur) | Une page web pour encoder un match, conçue pour un téléphone | L'opérateur au terrain |
| Grand écran | Une page web qui affiche un match en grand | Une TV, un projecteur ou un téléphone |
| Vue d'ensemble | Une page web qui affiche tous les terrains sur un seul écran | Une TV à la cafétéria |
Vous ne devez pas tout utiliser. Un match isolé n'a besoin que de l'application de bureau. Un tournoi utilise les pages web (Préparer, Programme, Aujourd'hui), un contrôleur par terrain et, si vous le souhaitez, un grand écran par terrain ainsi que la vue d'ensemble.
Notions clés
Terrain. Un match en cours, avec ses propres liens : un lien pour l'opérateur, un lien pour le grand écran et un code de participation de 8 caractères. Un tournoi compte un terrain par aire de jeu, salle ou table. Quand un match se termine, vous démarrez le suivant sur le même terrain.
Lien et code. Celui qui possède le lien de l'opérateur peut encoder ce terrain. Celui qui possède le lien du grand écran peut seulement regarder. Les liens contiennent un secret : ne les donnez donc qu'aux personnes de ce terrain. Si un QR code ne se scanne pas, tapez le code de participation sur /join.html.
Clé de l'organisateur. Un court secret affiché au démarrage du moteur et visible dans l'application de bureau. Elle déverrouille la page de l'organisateur. Ne la communiquez pas.
Matchs officiels et casual. Dans un match casual, vous comptez seulement le score. Dans un match officiel, vous avez en plus de vrais effectifs, des numéros de maillot, des cartons et des remplacements, et le programme les contrôle. Vous choisissez par tournoi ou par match.
Sport et tableau. Chaque sport a ses propres règles. Les sports qui fonctionnent de façon semblable partagent un même type de tableau de score :
- les sports d'équipe avec chrono (football, handball, basketball, hockey, rugby, arts martiaux, ...),
- les jeux et sets sans chrono (volleyball, badminton, tennis de table, squash, padel, tennis),
- les fléchettes.
Voir le guide des sports pour chaque sport.
Tout est conservé. Après chaque action, le match est enregistré. Si le programme, l'ordinateur portable ou le téléphone tombe en panne, rouvrez le match et continuez. Chaque action peut être annulée, une étape à la fois.
Le déroulement d'une journée de tournoi
- Démarrez l'application de bureau. Elle démarre le moteur et affiche la clé de l'organisateur.
- Dans Préparer : choisissez le ou les sports, créez les poules, ajoutez les équipes, créez les terrains.
- Ouvrez la fenêtre de partage de chaque terrain et donnez le lien de l'opérateur (QR code) au bénévole de ce terrain.
- Mettez la vue d'ensemble sur la TV de la cafétéria et les liens des grands écrans sur les écrans des terrains.
- Appuyez sur Démarrer tous les terrains au signal de départ. Les opérateurs encodent ; les scores apparaissent sur les écrans.
- Appuyez sur Démarrer le prochain match sur un terrain quand les équipes suivantes sont prêtes.
- À la fin, ouvrez le rapport et enregistrez-le en PDF ou en Excel, puis réinitialisez les terrains pour le tour suivant.
Le chapitre 1 vous guide pas à pas avec les boutons exacts.