Verbindet den ioBroker mit dem lokalen Autodarts Board Manager. Bietet Zustände und Ereignisse für das aktuelle Spiel, wodurch Lichter, Töne, Text-zu-Sprache oder andere Automatisierungen ausgelöst werden können.

Was dieser Adapter bewirkt

Verbindet sich mit Autodarts und stellt ioBroker-Zustände für die Hausautomation bereit:

Schalte das Licht ein, wenn ein Spiel beginnt
Spiele einen Ton auf die Zielscheibe
Den nächsten Wurf per Text-zu-Sprache (TTS) ankündigen
Hardware der Steuerplatine (Beleuchtung, Stromversorgung)
Löse beliebige andere ioBroker-Automatisierungen basierend auf Dart-Ereignissen aus.

Kompatibilität

Modus	Autodarts-Version	Wie es zusammenhängt
Lokal (Standard)	Board Client / Desktop vor Version 2	Umfragen vor Ort `IP:3180` (`/api/state`)
Wolke	Autodarts v2.0+ (Desktop / Terminal)	Autodarts Cloud WebSocket (Login + Board-ID)

Autodarts v2.0+: Die Web-Oberfläche des Board-Managers ist veraltet. Die lokale API auf Port 3180 Es kann weiterhin Anfragen beantworten (Verbindung, Kameras, Boardstatus), liefert aber keine Wurfdaten mehr (throws /numThrows Verwenden Sie den Cloud -Verbindungsmodus für die Wurferkennung in Version 2.

Dokumentation

🇺🇸 Dokumentation
🇩🇪 Dokumentation

Merkmale

Spielstand & Würfe

** visit.score ** Gesamtpunktzahl des letzten vollständigen Besuchs (3 Darts)
** throw.current ** : Numerische Punktzahl des zuletzt geworfenen Dartpfeils
** trigger.isTriple ** : Boolescher Wert für drei Treffer innerhalb eines konfigurierbaren Segmentbereichs (Standard: 1–20)
** trigger.isDouble ** : Boolescher Wert für Doppeltreffer (alle Segmente)
** trigger.isBullseye ** : Boolescher Wert für nur Volltreffer
** trigger.isMiss ** : Boolescher Wert, der auf „true“ gesetzt ist, wenn der Dartpfeil kein gültiges Wertungssegment trifft (rein verfehlt, keine Punkte).

Vorstandsstatus

** status.boardStatus ** : Statusanzeige eines Ereignisses im Vorstand (z. B. "Stopped", "Calibration finished", "Started").
** status.trafficLightColor ** : HEX-Farbe des aktuellen Platinenstatus
** status.trafficLightState ** : Statusanzeige
- green Der Spieler darf werfen
- yellow = Pfeile entfernen
- red = Board offline/Fehler

Systeminformationen

** system.software.* ** Autodarts-Versionen (Board-Version, Desktop-Version), Betriebssystem- und Plattformdetails
** system.hardware.* ** : CPU-Modell, Kernel-Architektur, Hostname
** system.cams.cam0/1/2 ** : Kamerakonfiguration (Breite, Höhe, fps) als JSON

Hardwaresteuerung

** system.hardware.light ** : Beleuchtung der Steuereinheit (bidirektional mit externen Zuständen)
** system.hardware.power ** : Stromversorgung der Steuerplatine (bidirektional mit externen Zuständen)

Laufzeitkonfiguration

** config.tripleMinScore/tripleMaxScore ** : Dreifach-Trigger-Schwellenwerte während der Laufzeit anpassen
** config.triggerResetSec ** Automatische Rücksetzzeit für Dreifach-/Doppel-/Volltreffer-/Fehlschuss-Flaggen

Tools-Addon-Integration

** tools.RAW ** : Eingabestatus, der zum Empfangen von Ereignissen von Browser-Tools verwendet wird (z. B. busted, gameon, gameshot, 180, matchshot, takeout).
** trigger.is180/isBusted/isGameon/isGameshot/isMatchshot/isTakeout ** : Schreibgeschützte Trigger-Flags werden gesetzt, wenn entsprechende Ereignisse über empfangen werden tools.RAW Die
** tools.config.url* ** : Vorgefertigte HTTP-URLs (einfache API-Aufrufe), die in die Browsererweiterung Tools for Autodarts kopiert werden können.

Was dieser Adapter NICHT leistet

❌ Es werden keine Verlaufsdaten, Statistiken oder personenbezogenen Daten gespeichert, die über die von ioBroker in den Zuständen gespeicherten Daten hinausgehen.
❌ Kein Zugriff auf die Boards anderer Nutzer.
❌ Keine Analysefunktionen

Datenschutz nach Modus

Lokaler Modus: Alle Boarddaten bleiben in Ihrem Netzwerk; von diesem Adapter werden keine Daten an die Autodarts-Server gesendet.
Cloud-Modus: Der Adapter authentifiziert sich mit Ihrem Autodarts-Konto und empfängt Spielereignisse von den Autodarts-Servern. Die Anmeldeinformationen bleiben in der Adapterkonfiguration gespeichert; aktivieren Sie die Zwei-Faktor-Authentifizierung für dieses Konto nicht, wenn Sie sich mit einem Passwort anmelden.

Konfiguration

Konfigurations-Screenshot

Die Adaptereinstellungen sind in vier Registerkarten unterteilt: OPTIONEN , ZUORDNUNGEN , TOOLS ADDON-INTEGRATION und HILFE & FAQ .

Registerkarte: OPTIONEN

Unter OPTIONEN konfigurieren Sie, wie der Adapter eine Verbindung zu Autodarts herstellt:

Verbindungsmodus
- local — den Board-Client in Ihrem LAN abfragen (IP:port (Standardeinstellung für Autodarts vor Version 2)
- cloud — Autodarts-Konto + Board-ID (erforderlich für die Wurferkennung von Autodarts v2)
Board-Host/IP (lokaler Modus)
IP-Adresse Ihres Autodarts-PCs (z. B. 192.168.178.50 oder 127.0.0.1).
Port (lokaler Modus)
TCP-Port des Board-Clients (normalerweise 3180).
Cloud-E-Mail / Passwort / Board-ID (Cloud-Modus)
Ihre Autodarts-Anmeldedaten und die Board-ID von „Meine Boards“ auf play.autodarts.io .
So finden Sie die Board-ID: Anmelden → Boards / Meine Boards → Ihr Board öffnen → UUID der Board-ID kopieren.
Details: Englische FAQ / Deutsche FAQ . Deaktivieren Sie die Zwei-Faktor-Authentifizierung, falls die Passwortanmeldung fehlschlägt.
Dreifacher Abzugsbereich
Zwei Dropdown-Menüs zur Festlegung der minimalen und maximalen Feldanzahl (1–20), die berücksichtigt werden soll für trigger.isTriple Die
Dreiergruppen außerhalb dieses Bereichs lösen keine Flagge aus.
Trigger-Reset(s)
Zeit in Sekunden, nach deren Ablauf die Flaggen für Dreifach-, Doppel-, Bullseye- und Fehlschüsse zurückgesetzt werden.
0 bedeutet, dass kein automatischer Reset erfolgt.
Abfrageintervall (s)
Wie oft der Adapter den Board Manager nach neuen Daten abfragt (z. B. 0.5, 1, 2 Sekunden).

Registerkarte: KARTEN

In MAPPINGS können Sie bestehende ioBroker-Zustände mit den hardwarebezogenen Adapterzuständen verknüpfen:

Lichtziel-ID
ioBroker-Status-ID, die mit system.hardware.light
(z.B 0_userdata.0.Autodarts.LIGHT oder ein Zustand einer intelligenten Leuchte/eines LED-Rings).
Leistungsziel-ID
ioBroker-Status-ID, die mit system.hardware.power
(z.B 0_userdata.0.Autodarts.POWER oder ein Zustand eines intelligenten Steckers).

Wenn die Konfiguration erfolgt, werden Änderungen auf beiden Seiten (Adapterstatus oder externer Status) bidirektional synchronisiert, sodass Sie das Board sowohl von ioBroker aus steuern als auch auf Board-Ereignisse reagieren können.

Registerkarte: WERKZEUGE-ADDON-INTEGRATION

Konfigurieren Sie IP-Adresse, Port und Instanz, damit der Adapter HTTP-URLs generieren kann, die auf Ihren ioBroker simple-api-Endpunkt verweisen.
Die endgültigen URLs für Busted, Game On und Gameshot werden als Zustände unter autodarts.X.tools.config.urlBusted/urlGameon/urlGameshot angezeigt und können in die Browsererweiterung Tools for Autodarts kopiert werden.

Registerkarte: Hilfe & Häufig gestellte Fragen

Unter HILFE & FAQ finden Sie allgemeine Informationen und Hilfestellungen zum Adapter und seiner Konfiguration.

Datenschutz und Datenverarbeitung

Lokaler Modus: Der Adapter liest Daten nur von Ihrem Autodarts-Board-Client in Ihrem eigenen Netzwerk.
Cloud-Modus: Der Adapter verbindet sich mit den Autodarts-Servern über Ihr Konto, um Board-/Match-Ereignisse zu empfangen (erforderlich für Autodarts v2).
Über die ioBroker-Zustände hinaus werden von diesem Adapter keine Statistiken oder Wurfhistorien erfasst oder weitergegeben.
Dieser Adapter ist nur für die Verwendung mit Ihrer eigenen Dartscheibe konzipiert.

Changelog

1.1.0 (2026-09-26)

(skvarel) Documented Autodarts v2 incompatibility for local throw detection
(skvarel) Added optional cloud connection mode for Autodarts v2 throw events
(skvarel) Documented how to find the Autodarts board ID for cloud / v2 setup

1.0.12 (2026-06-28)

(skvarel) Fixed admin i18n labels flagged as untranslated by the repository checker (fixes #67)

1.0.11 (2026-06-10)

(skvarel) Added meta object types for adapter and instance namespace

1.0.10 (2026-06-05)

(skvarel) Migrated project rules from GitHub Copilot to Cursor rules
(skvarel) Updated @alcalzone/release-script to 5.2.1 (fixes #59)
(skvarel) Replaced plain setInterval() and setTimeout() with adapter-managed this.setInterval(), adapter.setTimeout() and corresponding clear methods (fixes #59)

1.0.9 (2026-05-25)

(skvarel) Adapter requires node.js >= 22 now
(skvarel) Updated @alcalzone/release-script und Plugins auf 5.2.0 aktualisiert (fixes #56)
(skvarel) Downgraded @types/node auf ^22.0.0 heruntergestuft (fixes #56)

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Autodarts-Integration