SportScoreboard › DocumentatieDocumentationDocumentation

2. Installing and requirements

What you need

ComputerWindows 10 or 11, 64-bit
RuntimeNothing to install. The installer carries the .NET 10 runtime (Desktop and ASP.NET Core) that the program and the engine run on
Network (tournaments)One Wi-Fi network or router that the laptop and the phones share. No internet needed
Browser on the laptopThe program opens the controller and the big screen in a window of Microsoft Edge (comes with Windows 10/11) or Google Chrome, installed for all users or just for you. Without either, the pages open in your default browser as ordinary tabs and the program says so. Use a current version of Edge or Chrome
Phones and tabletsAny current browser (Chrome, Safari, Edge, Firefox). Nothing to install
Big screensAny device with a web browser: a TV with a browser, a laptop on an HDMI cable, a spare phone or tablet

Installing

The installer is on the SportScoreboard page of jthieren.be; the download is for signed-in members of the site (free for the non-profits it is meant for). Run setup_SportScoreboard_<version>.exe. By default it installs for the current user only, so it needs no administrator rights. Setup also offers Install for all users (Windows asks for administrator approval): then the program goes into Program Files and the installer adds the Windows Firewall rule for the engine for you. It also offers a desktop icon. If a program of this name is running, the installer asks you to close it first. Windows may show a SmartScreen warning because the installer is not code-signed. Each release comes with a .sha256 file: compare it with the checksum of the installer (Get-FileHash) if you want to be sure the file is the one that was published.

The installer is complete: it contains the desktop app, the Scoreboard Engine with its web pages and these manuals, the report libraries, sample reports and the .NET 10 runtime (Desktop and ASP.NET Core) they run on. There is nothing else to install or download, also not at a venue without internet. (It is about 55 MB; installed it takes about 175 MB.) The desktop app finds the engine in its own folder.

First start

Start SportScoreboard. On the first start the language follows Windows (English, Dutch, French or German); change it later in Settings…. The program starts the Scoreboard Engine in the background and shows its state in the top right:

TextMeaning
Engine: starting…The engine is being started
Engine: ready — this PC onlyRunning, reachable from this PC only (the safe default)
Engine: ready — open to phonesRunning and reachable from the network
Engine: not running + RetryIt could not be started; see Troubleshooting

The button next to the text offers the other mode: Open to phones while the engine is local, This PC only while it is open. Confirm the question; the engine restarts briefly and running matches come back.

Windows Firewall

If you installed for all users, the installer already added a firewall rule ("SportScoreboard Engine", private and domain networks) and removes it on uninstall. Otherwise the first time the engine opens to the network, Windows asks whether to allow it. Allow it on private networks. The engine listens on port 5115. If phones cannot connect, the firewall is the usual reason.

More than one network

If the PC has more than one active network (for example Ethernet and Wi-Fi) the program asks Which network?. Pick the one the phones are on: that address goes into every link and QR code.

Keep the network private

The engine talks plain HTTP (not encrypted), and every operator link and QR code contains a secret code. Someone on the same Wi-Fi who knows how to listen in could copy such a link and score a court. So:

  • Use your own router or a phone hotspot with a password, just for the tournament. Do not use the open guest Wi-Fi of the venue or a network shared with strangers.
  • Do not switch on "client isolation" / "AP isolation": the phones must be able to reach the laptop (see Troubleshooting).
  • Give the Wi-Fi password only to the volunteers and referees, and change it after the event.
  • Do not post photos of QR codes or links in chats outside the court's team. An operator link scores the match, a big screen link only watches: protect the first kind.
  • A link keeps working until its match is finished and removed.

Where your data lives

WhatWhere
Teams, referees, settings, logs%LocalAppData%\SportScoreboard
Tournament data of the engine (courts, pools, team list)the same folder (engine-courts, tournament.json, ...)
Matches you save yourselfwhere you choose (default Documents\SportScoreboard)

Installed for all users: the installer then also makes %ProgramData%\SportScoreboard, and everything above except your settings, browser windows' profiles, downloaded installers and logs is kept there, so every Windows user of this PC works on the same teams, results and courts. The first time, the data you already had in %LocalAppData%\SportScoreboard is copied in (the original stays). A per-user install keeps everything in %LocalAppData% as before.

The organizer key on a shared PC: with a shared data folder the running engine leaves its key where every Windows user of this PC can use it, so a second volunteer's program opens the organizer pages without typing it. The key is protected so that a copy of the file on another PC is useless, it is only valid while that engine runs, and the file disappears when the engine stops. Anyone who can log on to this PC can use it, so give accounts on the PC only to people you trust with the tournament. Phones still need the key or a QR code to organize.

The program collects no data and sends nothing to the internet. Player names stay on the computer. To wipe everything, close the program and delete the folder above. Uninstalling does not delete it, so an update never costs you your teams.

Updating and uninstalling

Run the new installer over the old one: your data stays. Uninstall from Windows Settings → Apps.

Closing the program

When you close the desktop app while the engine is running, it asks:

  • Exit, keep the engine running — the safe choice during a tournament: phones and screens keep working.
  • Stop the engine and exit — also closes the controller and big-screen windows and stops the engine.
  • Stay — go back.

If a match is being played, the window says so and warns that stopping the engine ends it for everyone watching (the scores are saved). If the program is closed in any other way while a match is being played (it crashes, or is ended in Task Manager), the engine keeps running by itself and stops a couple of minutes after the last match is over, or when nobody has watched or touched it for three hours. When nothing is being played it stops at once.

2. Installeren en vereisten

Wat je nodig hebt

ComputerWindows 10 of 11, 64-bit
RuntimeNiets te installeren. Het installatieprogramma bevat de .NET 10-runtime (Desktop en ASP.NET Core) waarop het programma en de engine draaien
Netwerk (toernooien)Eén wifinetwerk of router die de laptop en de gsm's delen. Internet is niet nodig
Browser op de laptopHet programma opent de controller en het groot scherm in een venster van Microsoft Edge (zit in Windows 10/11) of Google Chrome, geïnstalleerd voor alle gebruikers of alleen voor jou. Zonder beide openen de pagina's in je standaardbrowser als gewone tabbladen en zegt het programma dat. Gebruik een actuele versie van Edge of Chrome
Gsm's en tabletsEen gangbare browser (Chrome, Safari, Edge, Firefox). Niets te installeren
Grote schermenElk toestel met een webbrowser: een tv met browser, een laptop op een HDMI-kabel, een reservegsm of -tablet

Installeren

Het installatieprogramma staat op de pagina van SportScoreboard op jthieren.be; de download is voor aangemelde leden van de site (gratis voor de vzw's waarvoor het bedoeld is). Start setup_SportScoreboard_<version>.exe. Standaard installeert het enkel voor de huidige gebruiker, dus je hebt geen beheerdersrechten nodig. De installatie biedt ook Install for all users aan (Windows vraagt dan om goedkeuring van een beheerder): dan komt het programma in Program Files en voegt het installatieprogramma voor jou de Windows Firewall-regel voor de engine toe. Het biedt ook een bureaubladpictogram aan. Als een programma met deze naam draait, vraagt het installatieprogramma om het eerst te sluiten. Windows kan een SmartScreen-waarschuwing tonen omdat het installatieprogramma niet digitaal ondertekend is. Elke versie komt met een .sha256-bestand: vergelijk dat met de controlesom van het installatieprogramma (Get-FileHash) als je zeker wilt zijn dat het bestand hetzelfde is als het bestand dat gepubliceerd werd.

Het installatieprogramma is volledig: het bevat de desktop-app, de Scoreboard Engine met haar webpagina's en deze handleidingen, de verslagbibliotheken, voorbeeldverslagen en de .NET 10-runtime (Desktop en ASP.NET Core) waarop ze draaien. Er is niets anders te installeren of te downloaden, ook niet op een locatie zonder internet. (Het is ongeveer 55 MB groot; geïnstalleerd neemt het ongeveer 175 MB in.) De desktop-app vindt de engine in haar eigen map.

Eerste start

Start SportScoreboard. Bij de eerste start volgt de taal die van Windows (Engels, Nederlands, Frans of Duits); wijzig ze later in Instellingen…. Het programma start de Scoreboard Engine op de achtergrond en toont haar toestand rechtsboven:

TekstBetekenis
Engine: start op…De engine wordt gestart
Engine: klaar — enkel deze pcZe draait en is enkel bereikbaar vanaf deze pc (de veilige standaard)
Engine: klaar — open voor gsm'sZe draait en is bereikbaar vanaf het netwerk
Engine: draait niet + Opnieuw proberenZe kon niet gestart worden; zie Problemen oplossen

De knop naast de tekst biedt de andere modus aan: Openen voor gsm's zolang de engine lokaal is, Enkel deze pc zolang ze open is. Bevestig de vraag; de engine herstart kort en lopende wedstrijden komen terug.

Windows Firewall

Als je voor alle gebruikers hebt geïnstalleerd, heeft het installatieprogramma al een firewallregel toegevoegd ("SportScoreboard Engine", privé- en domeinnetwerken) en verwijdert het ze bij het deïnstalleren. Anders vraagt Windows de eerste keer dat de engine zich voor het netwerk opent of je ze wilt toelaten. Laat ze toe op privénetwerken. De engine luistert op poort 5115. Als gsm's niet kunnen verbinden, is de firewall meestal de reden.

Meer dan één netwerk

Als de pc meer dan één actief netwerk heeft (bijvoorbeeld Ethernet en wifi), vraagt het programma Welk netwerk?. Kies het netwerk waarop de gsm's zitten: dat adres komt in elke link en QR-code.

Houd het netwerk privé

De engine praat gewoon HTTP (niet versleuteld) en elke operatorlink en QR-code bevat een geheime code. Iemand op hetzelfde wifi die weet hoe je meeluistert, kan zo'n link kopiëren en een veld bedienen. Dus:

  • Gebruik je eigen router of een hotspot met wachtwoord, enkel voor het toernooi. Gebruik niet het open gastenwifi van de zaal of een netwerk dat je met vreemden deelt.
  • Zet "client isolation" / "AP-isolatie" niet aan: de gsm's moeten de laptop kunnen bereiken (zie Problemen oplossen).
  • Geef het wifi-wachtwoord enkel aan de vrijwilligers en scheidsrechters en verander het na het evenement.
  • Plaats geen foto's van QR-codes of links in chats buiten het team van het veld. Een operatorlink bedient de wedstrijd, een groot scherm-link kijkt enkel mee: bescherm de eerste soort.
  • Een link blijft werken tot de wedstrijd afgelopen en verwijderd is.

Waar je gegevens staan

WatWaar
Teams, scheidsrechters, instellingen, logs%LocalAppData%\SportScoreboard
Toernooigegevens van de engine (velden, poules, teamlijst)dezelfde map (engine-courts, tournament.json, ...)
Wedstrijden die je zelf opslaatwaar je kiest (standaard Documents\SportScoreboard)

Voor alle gebruikers geïnstalleerd: het installatieprogramma maakt dan ook %ProgramData%\SportScoreboard aan, en alles hierboven behalve je instellingen, de profielen van de browservensters, gedownloade installatieprogramma's en logs staat daar, zodat elke Windows-gebruiker van deze pc met dezelfde teams, resultaten en velden werkt. De eerste keer worden de gegevens die je al in %LocalAppData%\SportScoreboard had erin gekopieerd (het origineel blijft). Een installatie enkel voor jou houdt alles in %LocalAppData% zoals voorheen.

De organisatorsleutel op een gedeelde pc: met een gedeelde gegevensmap legt de draaiende engine zijn sleutel neer waar elke Windows-gebruiker van deze pc ze kan gebruiken, zodat het programma van een tweede vrijwilliger de organisatorpagina's opent zonder te typen. De sleutel is zo beschermd dat een kopie van het bestand op een andere pc nutteloos is, ze geldt alleen zolang die engine draait en het bestand verdwijnt als de engine stopt. Iedereen die op deze pc kan aanmelden, kan ze gebruiken: geef dus enkel accounts op de pc aan mensen die je het toernooi toevertrouwt. Gsm's hebben om te organiseren nog altijd de sleutel of een QR-code nodig.

Het programma verzamelt geen gegevens en stuurt niets naar het internet. Spelersnamen blijven op de computer. Om alles te wissen, sluit je het programma en verwijder je de map hierboven. Deïnstalleren verwijdert ze niet, zodat een update je teams nooit kost.

Bijwerken en deïnstalleren

Start het nieuwe installatieprogramma over het oude: je gegevens blijven. Deïnstalleer via Windows-instellingen → Apps.

Het programma sluiten

Als je de desktop-app sluit terwijl de engine draait, vraagt ze:

  • Afsluiten, engine laten draaien — de veilige keuze tijdens een toernooi: gsm's en schermen blijven werken.
  • Engine stoppen en afsluiten — sluit ook de controller- en groot-schermvensters en stopt de engine.
  • Blijven — ga terug.

Als er een wedstrijd wordt gespeeld, zegt het venster dat en waarschuwt het dat de engine stoppen de wedstrijd beëindigt voor iedereen die kijkt (de scores worden bewaard). Wordt het programma op een andere manier gesloten terwijl er een wedstrijd wordt gespeeld (het crasht, of wordt beëindigd in Taakbeheer), dan blijft de engine zelf doorlopen en stopt ze een paar minuten nadat de laatste wedstrijd afgelopen is, of wanneer niemand ze drie uur lang bekeken of aangeraakt heeft. Wordt er niets gespeeld, dan stopt ze meteen.

2. Installation et configuration requise

Ce qu'il vous faut

OrdinateurWindows 10 ou 11, 64 bits
Environnement d'exécutionRien à installer. Le programme d'installation contient l'environnement .NET 10 (Desktop et ASP.NET Core) sur lequel tournent le programme et le moteur
Réseau (tournois)Un réseau Wi-Fi ou un routeur que l'ordinateur portable et les téléphones partagent. Pas besoin d'internet
Navigateur sur l'ordinateurLe programme ouvre le contrôleur et le grand écran dans une fenêtre de Microsoft Edge (fourni avec Windows 10/11) ou de Google Chrome, installé pour tous les utilisateurs ou pour vous seul. Sans l'un ni l'autre, les pages s'ouvrent dans votre navigateur par défaut comme onglets ordinaires, et le programme le signale. Utilisez une version actuelle d'Edge ou de Chrome
Téléphones et tablettesN'importe quel navigateur récent (Chrome, Safari, Edge, Firefox). Rien à installer
Grands écransN'importe quel appareil doté d'un navigateur web : une TV avec navigateur, un ordinateur portable relié par un câble HDMI, un téléphone ou une tablette de réserve

Installation

L'installateur se trouve sur la page de SportScoreboard sur jthieren.be ; le téléchargement est réservé aux membres connectés du site (gratuit pour les associations à qui il est destiné). Lancez setup_SportScoreboard_<version>.exe. Par défaut, il s'installe uniquement pour l'utilisateur actuel, et ne demande donc aucun droit d'administrateur. Le programme d'installation propose aussi Installer pour tous les utilisateurs (Windows demande l'accord d'un administrateur) : le programme est alors placé dans Program Files et le programme d'installation ajoute pour vous la règle du pare-feu Windows pour le moteur. Il propose aussi une icône sur le bureau. Si un programme de ce nom est en cours d'exécution, le programme d'installation vous demande de le fermer d'abord. Windows peut afficher un avertissement SmartScreen parce que le programme d'installation n'est pas signé numériquement. Chaque version est fournie avec un fichier .sha256 : comparez-le à la somme de contrôle du programme d'installation (Get-FileHash) si vous voulez être certain que le fichier est bien celui qui a été publié.

Le programme d'installation est complet : il contient l'application de bureau, le Scoreboard Engine avec ses pages web et ces manuels, les bibliothèques de rapports, des exemples de rapports et l'environnement .NET 10 (Desktop et ASP.NET Core) sur lequel ils tournent. Il n'y a rien d'autre à installer ni à télécharger, même sur un site sans internet. (Il pèse environ 55 Mo ; une fois installé, il occupe environ 175 Mo.) L'application de bureau trouve le moteur dans son propre dossier.

Premier démarrage

Démarrez SportScoreboard. Au premier démarrage, la langue suit celle de Windows (anglais, néerlandais, français ou allemand) ; vous pouvez la changer plus tard dans Paramètres…. Le programme démarre le Scoreboard Engine en arrière-plan et affiche son état en haut à droite :

TexteSignification
Moteur : démarrage…Le moteur est en cours de démarrage
Moteur : prêt — ce PC seulementIl tourne, et n'est accessible que depuis ce PC (le réglage par défaut, le plus sûr)
Moteur : prêt — ouvert aux téléphonesIl tourne et est accessible depuis le réseau
Moteur : arrêté + RéessayerIl n'a pas pu démarrer ; voir Dépannage

Le bouton à côté du texte propose l'autre mode : Ouvrir aux téléphones tant que le moteur est local, Ce PC seulement tant qu'il est ouvert. Confirmez la question ; le moteur redémarre brièvement et les matchs en cours reviennent.

Pare-feu Windows

Si vous avez installé pour tous les utilisateurs, le programme d'installation a déjà ajouté une règle de pare-feu (« SportScoreboard Engine », réseaux privés et de domaine) et la supprime à la désinstallation. Sinon, la première fois que le moteur s'ouvre au réseau, Windows demande s'il faut l'autoriser. Autorisez-le sur les réseaux privés. Le moteur écoute sur le port 5115. Si les téléphones n'arrivent pas à se connecter, le pare-feu en est la cause habituelle.

Plus d'un réseau

Si le PC a plus d'un réseau actif (par exemple Ethernet et Wi-Fi), le programme demande Quel réseau ?. Choisissez celui sur lequel se trouvent les téléphones : cette adresse est utilisée dans chaque lien et chaque QR code.

Garder le réseau privé

Le moteur parle en HTTP simple (non chiffré), et chaque lien opérateur et chaque QR code contient un code secret. Quelqu'un sur le même Wi-Fi qui sait écouter le réseau pourrait copier un tel lien et piloter un terrain. Donc :

  • Utilisez votre propre routeur ou un point d'accès mobile avec mot de passe, uniquement pour le tournoi. N'utilisez pas le Wi-Fi invité ouvert de la salle ni un réseau partagé avec des inconnus.
  • N'activez pas l'« isolation des clients » / « isolation AP » : les téléphones doivent pouvoir joindre l'ordinateur (voir Dépannage).
  • Ne donnez le mot de passe Wi-Fi qu'aux bénévoles et aux arbitres, et changez-le après l'événement.
  • Ne publiez pas de photos de QR codes ou de liens dans des discussions hors de l'équipe du terrain. Un lien opérateur pilote le match, un lien grand écran ne fait que regarder : protégez le premier type.
  • Un lien reste valable jusqu'à ce que son match soit terminé et supprimé.

Où se trouvent vos données

QuoiOù
Équipes, arbitres, paramètres, journaux%LocalAppData%\SportScoreboard
Données du tournoi du moteur (terrains, poules, liste des équipes)le même dossier (engine-courts, tournament.json, ...)
Matchs que vous enregistrez vous-mêmelà où vous le choisissez (par défaut Documents\SportScoreboard)

Installé pour tous les utilisateurs : l'installateur crée alors aussi %ProgramData%\SportScoreboard, et tout ce qui précède, sauf vos réglages, les profils des fenêtres du navigateur, les installateurs téléchargés et les journaux, y est conservé : chaque utilisateur Windows de ce PC travaille sur les mêmes équipes, résultats et terrains. La première fois, les données que vous aviez déjà dans %LocalAppData%\SportScoreboard y sont copiées (l'original reste). Une installation pour vous seul garde tout dans %LocalAppData% comme avant.

La clé d'organisateur sur un PC partagé : avec un dossier de données partagé, le moteur en cours laisse sa clé là où chaque utilisateur Windows de ce PC peut l'utiliser, de sorte que le programme d'un deuxième bénévole ouvre les pages d'organisateur sans la saisir. La clé est protégée pour qu'une copie du fichier sur un autre PC soit inutile, elle n'est valable que tant que ce moteur tourne, et le fichier disparaît quand le moteur s'arrête. Quiconque peut se connecter à ce PC peut l'utiliser : ne donnez des comptes sur le PC qu'à des personnes à qui vous confiez le tournoi. Les téléphones ont toujours besoin de la clé ou d'un QR code pour organiser.

Le programme ne collecte aucune donnée et n'envoie rien sur internet. Les noms des joueurs restent sur l'ordinateur. Pour tout effacer, fermez le programme et supprimez le dossier ci-dessus. La désinstallation ne le supprime pas : une mise à jour ne vous fait donc jamais perdre vos équipes.

Mise à jour et désinstallation

Lancez le nouveau programme d'installation par-dessus l'ancien : vos données restent. Désinstallez via Paramètres Windows → Applications.

Fermer le programme

Quand vous fermez l'application de bureau alors que le moteur tourne, elle demande :

  • Quitter, laisser le moteur actif — le choix le plus sûr pendant un tournoi : les téléphones et les écrans continuent de fonctionner.
  • Arrêter le moteur et quitter — ferme aussi les fenêtres du contrôleur et du grand écran et arrête le moteur.
  • Rester — revenir en arrière.

Si un match est en cours, la fenêtre le dit et avertit que l'arrêt du moteur l'interrompt pour tous ceux qui regardent (les scores sont enregistrés). Si le programme est fermé autrement pendant un match (il plante, ou est terminé dans le Gestionnaire des tâches), le moteur continue tout seul et s'arrête quelques minutes après la fin du dernier match, ou quand personne ne l'a regardé ni touché pendant trois heures. Quand rien n'est joué, il s'arrête aussitôt.

An unhandled error has occurred. Reload 🗙