Game Shot Darts unter Linux installieren

Für x86_64-PCs (Debian 12+, Ubuntu 22.04+ und ähnliche) und ARM64-Boards wie den Raspberry Pi 5 (64-Bit-Raspberry-Pi-OS). Keine Root-Rechte nötig, Python und Node.js werden nicht gebraucht.

Andere Systeme: macOS · Windows · English: Linux

1. Installieren

Im Terminal:

curl -fsSL https://gameshotdarts.app/install.sh | sh

Das Skript lädt das neueste Release für deinen Prozessor und installiert:

Was	Wo
Programm	`~/.local/lib/gameshotdarts`
Befehl `gameshotdarts`	`~/.local/bin/gameshotdarts`
Eintrag im App-Menü und Desktop-Verknüpfung	`~/.local/share/applications/gameshotdarts.desktop`, `~/Desktop/gameshotdarts.desktop`
Einstellungen und Daten (beim ersten Start angelegt)	`~/.local/share/gameshotdarts` (`config.toml`, `data/`)

Lieber von Hand herunterladen? Lade gameshotdarts-<version>-linux-x86_64.tar.gz (oder -linux-arm64) von der Download-Seite, dann:

tar -xzf gameshotdarts-*-linux-*.tar.gz

./gameshotdarts-*/install.sh

2. Kamerazugriff

Linux erlaubt Kameras nur Mitgliedern der Gruppe video. Füge dich einmal hinzu und melde dich danach ab und wieder an:

sudo usermod -aG video $USER

v4l-utils wird empfohlen: Game Shot Darts setzt damit Kamera-Einstellungen wie eine feste Belichtung.

sudo apt install v4l-utils

3. Starten

Klicke auf Game Shot Darts im App-Menü oder auf dem Desktop. Ein Terminal-Fenster mit dem Server-Log und den Adressen öffnet sich, und der Browser zeigt die Game-Shot-Darts-Oberfläche unter http://localhost:8000. Schließe das Terminal-Fenster (oder drücke darin Strg+C), um Game Shot Darts zu beenden. Läuft Game Shot Darts bereits, öffnet die Verknüpfung nur den Browser.

GNOME: Zeigt die Desktop-Verknüpfung ein Warnsymbol, klicke sie mit rechts an und wähle Start erlauben. Desktop-Symbole brauchen unter GNOME die Erweiterung Desktop Icons NG (bei Ubuntu vorinstalliert).

Im Terminal geht dasselbe mit gameshotdarts launch; gameshotdarts serve startet nur den Server.

Handys, Tablets und Fernseher im Heimnetz öffnen http://<Adresse dieses Computers>:8000; das Terminal-Fenster zeigt die Adressen, die Oberfläche zeigt einen QR-Code.

4. Kameras einrichten

In der App: Einstellungen → Kameras → Kameras einrichten. Kameras suchen listet die angeschlossenen Kameras; füge die drei Dart-Kameras hinzu, wähle für jede, wo sie hängt (oben, unten rechts, unten links), und klicke Speichern und neu starten. Game Shot Darts schreibt sie in config.toml und startet von selbst neu; danach auf derselben Seite die Scheibe kalibrieren.

Dasselbe von Hand, oder für Optionen, die die App nicht zeigt (Auflösung, Kamera-Regler):

gameshotdarts devices

Listet die angeschlossenen Kameras mit ihren stabilen Pfaden /dev/v4l/by-path/... auf. Öffne ~/.local/share/gameshotdarts/config.toml, entferne das # vor den drei [[cameras]]-Blöcken und trage diese Pfade als device ein. Starte Game Shot Darts dann neu und kalibriere die Scheibe auf der Seite Kameras der Oberfläche.

Die Kommentare in config.toml erklären die Optionen (Auflösung, Belichtung, Erkennung).

5. Beim Hochfahren starten (optional)

Auf einem reinen Dart-Rechner kann Game Shot Darts als systemd-Benutzerdienst laufen, der mit dem Computer startet, ohne dass sich jemand anmelden muss:

curl -fsSL https://gameshotdarts.app/install.sh | sh -s -- --service

(oder ./install.sh --service aus dem entpackten Archiv). Die Desktop-Verknüpfung öffnet dann nur noch den Browser. Nützliche Befehle:

systemctl --user status gameshotdarts

journalctl --user -u gameshotdarts -f

Meldet das Skript, dass Lingering nicht aktiviert werden konnte, führe einmal sudo loginctl enable-linger $USER aus; sonst läuft der Dienst nur, solange du angemeldet bist.

Aktualisieren

Den Installationsbefehl erneut ausführen. Einstellungen, Daten und ein eingerichteter Autostart-Dienst bleiben erhalten.

Deinstallieren

curl -fsSL https://gameshotdarts.app/install.sh | sh -s -- --uninstall

Entfernt Programm, Verknüpfungen und Dienst. Einstellungen und Daten bleiben in ~/.local/share/gameshotdarts; lösche den Ordner auch, um alles zu entfernen.

Fehlerbehebung

Problem	Lösung
`gameshotdarts: command not found`	`~/.local/bin` ist nicht im `PATH`. Ab- und wieder anmelden (die meisten Distributionen nehmen den Ordner automatisch auf, sobald er existiert) oder den vollen Pfad `~/.local/bin/gameshotdarts` verwenden.
Kamera meldet „Cannot open camera“	Gruppe `video` fehlt (siehe Schritt 2) oder ein anderes Programm nutzt die Kamera (`fuser /dev/video*`).
Terminal-Fenster schließt sich sofort	`gameshotdarts launch` im Terminal starten, um den Fehler zu sehen. Port 8000 belegt: unter `[server]` in `config.toml` einen anderen `port` eintragen.
Handys verbinden sich nicht	Port 8000 in der Firewall freigeben, z. B. `sudo ufw allow 8000/tcp`.