Autodarts for Home Assistant¶
Your Autodarts board, live in Home Assistant: local, realtime and ready for automations.
Darts appear in Home Assistant a fraction of a second after they land, straight from the Board Manager in your network. Play and train with them, put a scoreboard next to the board, follow your statistics and let your home join in. No account, no cloud, no client ID.
Add to HACS Get started Try it live
What it does¶
-
Local and in realtime
Found automatically with Board Manager 2; Board Manager 1 works too. Nothing leaves your network unless you use the board search, the cloud link or the online bridge, and board secrets are never stored.
-
Games
X01 from 101 to 1001 with the checkout route after every dart, Cricket, Cut-Throat Cricket, Tactics and Wild Mouse, and six party games for up to eight, alone or as a match of up to four with legs, sets, teams and handicaps.
-
Training
Training sessions that start with the first dart, eight training games from Around the Clock to the JDC Challenge, a daily goal, a training streak and personal bests.
-
Scoreboard and cards
A scoreboard for a tablet or TV, readable from the oche, with a new game screen, a caller and idle mode. Seven dashboard cards and an automatic dashboard, in English, German, Dutch, French and Spanish.
-
Statistics with heatmaps
3-dart average, first 9 average, checkout and doubles rate, a heatmap of every bed or of the real dart positions, and where each player scores the most per dart. Player profiles with badges, weekly trends, a leaderboard, a weekly report and a training calendar.
-
Automations and blueprints
Board events for every dart, visit, takeout, bust, won leg and match. Twelve blueprints: light show, dart and practice callers, highlight photos, reports, alerts and routines.
-
Tournaments and a bot
Tournaments of three to eight players, as a round robin with a table or a knockout with a bracket, and a bot from level 20 to 120 to play X01 and Cricket against.
-
Voice
Say "Start 501 for Alex and Sam" to Assist, in English, German, Spanish, French or Dutch, and the game starts; then "Alex has 140" or "Triple 20" enters the darts, as at a dart machine. Any game also starts with one action of an automation.
Guides¶
-
For Autodarts players without Home Assistant: set up Home Assistant and HACS, install the integration, add the board and play the first game on the scoreboard.
-
Requirements, HACS and manual installation, the ways to add a board, the optional cloud link, reconfiguration, updating and removal.
-
Any dartboard, with every game, the training and the statistics: you enter the darts on a keypad.
-
Every game at a glance, four ways to start one, matches, teams, handicaps, the bull-off, tournaments and the rules of every game.
-
A tablet or TV next to the board: setup, landscape and portrait, the new game screen, tournaments, the caller and idle mode.
-
Training sessions, personal bests, the heatmap and dart positions, where to aim, progress over time, doubles, player profiles, achievements, the leaderboard and exports.
-
Twelve blueprints, their settings, board events and ready-to-use examples.
-
Busts, won legs and matches of online matches as board events, with the browser extension Tools for Autodarts (experimental).
Reference¶
-
All seven cards and the automatic dashboard, with every option and accessibility.
-
Every entity, board event, state, attribute and action, and which Board Manager generation provides it.
-
Architecture, update intervals, connection behavior, training and records, stored data and privacy.
-
Setup messages, repairs, unavailable entities, failing actions, diagnostics and logs.
-
What is protected, trust boundaries, threats and countermeasures.
-
The words of darts and of this integration, with their German terms.
What every version brought is in the changelog, what comes next in the roadmap. For videos and articles, the creator kit has facts, videos and pictures, free to use.
Supported devices¶
| Supported | Tested with | |
|---|---|---|
| Board Manager 2: Autodarts 2 without a screen (headless) | 2.x | 2.0.0 and 2.0.2 |
| Board Manager 1 (classic app) | 1.x | 1.0.7 |
| Autodarts Desktop on Linux | Works, as reported by a player | 2.0.2 on Ubuntu 24.04 (report) |
| Autodarts Desktop on Windows and other systems | Not tested yet | – |
| Winmau Autodarts devices such as Autodarts X or Lens | Not tested yet | – |
| Cameras | Any number supported by the Board Manager | 3 |
| Home Assistant | 2026.8 or newer | 2026.8.0 and 2026.9.4 |
Any board hardware that runs the Autodarts Board Manager works, because the integration talks to the Board Manager, not to the cameras. Rows reported by a player were tested by a player on their own board, not by the project.
Since September 2026, the Autodarts documentation describes the Board Manager as the browser interface of Autodarts 0.x that is not supported from version 2 on. The local interface on port 3180 that the integration uses still answers on Autodarts 2.0.2. If an update changes it, the integration shows a repair notice instead of failing silently (see troubleshooting). If your setup is not in the table, a compatibility report helps, even when everything works.
Languages¶
The integration speaks English, German, Dutch, French and Spanish: setup, options, entities and their states, actions, messages and repairs, the cards with their editors and the caller of the scoreboard. It follows the language of Home Assistant; a regional variant such as de-CH or es-419 counts as its language. Other languages see English.
- Home Assistant names the entities in the language of the server (Settings → System → General); states and cards follow the language of your user profile.
- The caller speaks the card's language with a voice of your browser or tablet for that language.
- The documentation is in English and German, the blueprints in English because Home Assistant does not translate blueprints. The voice blueprints understand sentences in all five languages, and Assist answers in the language of Home Assistant.
Texts that are missing in a language, or older than their English original, are listed in that language's translation issue, which a bot keeps up to date. It explains how to fix them right on GitHub, without programming. To improve a translation or add a language, see translations in CONTRIBUTING.md.
