Game Shot Darts unter macOS installieren

Für Macs mit Apple Silicon (M1 oder neuer) und macOS 14 Sonoma oder neuer. Python und Node.js werden nicht gebraucht. Intel-Macs werden nicht unterstützt.

Andere Systeme: Linux · Windows · English: macOS

1. Installieren

Lade gameshotdarts-<version>-macos-arm64.dmg von der Download-Seite, öffne es und zieh Game Shot Darts auf Programme. Die App ist von der CodeFabrik GmbH signiert und von Apple beglaubigt, macOS öffnet sie ohne Warnung.

Was	Wo
App	/Applications/Game Shot Darts.app
Einstellungen und Daten (beim ersten Start angelegt)	~/Library/Application Support/gameshotdarts (config.toml, data/)

Lieber per Terminal? Das installiert dieselbe App, dazu eine Verknüpfung auf dem Schreibtisch und den Befehl gameshotdarts (~/.local/bin/gameshotdarts), den die Kamera-Befehle weiter unten nutzen:

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

2. Starten

Doppelklicke Game Shot Darts auf dem Schreibtisch, im Launchpad oder im Programme-Ordner. Game Shot Darts öffnet sich wie jede andere App in einem eigenen Fenster; der Server läuft im Hintergrund, solange das Fenster offen ist. Schließe das Fenster oder beende mit ⌘Q, um Game Shot Darts zu stoppen. Das Log landet in ~/Library/Application Support/gameshotdarts/gameshotdarts.log.

Lieber im Browser? gameshotdarts launch --browser im Terminal startet den Server und öffnet die Oberfläche im Standardbrowser (Ctrl+C beendet).

Beim ersten Start fragt macOS:

• „Game Shot Darts möchte auf die Kamera zugreifen“ (nur mit Kameras in config.toml) – erlauben, Game Shot Darts liest die Kameras an der Scheibe. Später änderbar unter Systemeinstellungen → Datenschutz & Sicherheit → Kamera.
• „Soll das Programm eingehende Netzwerkverbindungen akzeptieren?“ – erlauben, damit Handys und Tablets sich verbinden können.

Um Game Shot Darts aus dem Dock zu starten, zieh Game Shot Darts.app aus dem Programme-Ordner ins Dock.

Handys, Tablets und Fernseher im Heimnetz öffnen http://<Adresse dieses Macs>:8000; die Startseite der App zeigt die Adresse und einen QR-Code.

3. 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):

Im Terminal:

~/.local/bin/gameshotdarts devices

Die Kameras werden mit Nummer aufgelistet (0, 1, 2, …); die eingebaute FaceTime-Kamera ist meist 0. Öffne die Einstellungsdatei:

open -e ~/Library/Application\ Support/gameshotdarts/config.toml

Entferne das # vor den drei [[cameras]]-Blöcken und trage die Nummern der Dart-Kameras als device ein. Beende und starte Game Shot Darts dann neu und kalibriere die Scheibe auf der Seite Kameras der Oberfläche.

Hinweise für macOS:

• Kameranummern können sich ändern, wenn Kameras an andere Anschlüsse gesteckt werden; lass jede Kamera im selben Anschluss.
• v4l2_controls (feste Belichtung usw.) gibt es nur unter Linux, hier werden sie ignoriert.

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

4. Bei der Anmeldung starten (optional)

Systemeinstellungen → Allgemein → Anmeldeobjekte → + → Game Shot Darts.app wählen. Game Shot Darts öffnet sich dann nach jeder Anmeldung in seinem Fenster.

Aktualisieren

Den Installationsbefehl erneut ausführen. Einstellungen und Daten bleiben erhalten.

Deinstallieren

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

Entfernt die App, die Schreibtisch-Verknüpfung und den Befehl. Einstellungen und Daten bleiben in ~/Library/Application Support/gameshotdarts; lösche den Ordner auch, um alles zu entfernen.

Fehlerbehebung

Problem	Lösung
Kein Kamerabild, im Log steht „not authorized to capture video“	Systemeinstellungen → Datenschutz & Sicherheit → Kamera → Game Shot Darts aktivieren, dann Game Shot Darts neu starten.
Das Fenster meldet „Game Shot Darts could not start“	Die im Fenster genannte Log-Datei ansehen; meist ist Port 8000 belegt (nächste Zeile).
Port 8000 ist belegt	Unter [server] in config.toml einen anderen port eintragen.
Handys verbinden sich nicht	Systemeinstellungen → Netzwerk → Firewall → Optionen: eingehende Verbindungen für gameshotdarts erlauben.