HomeDarts for Autodarts¶
Your Autodarts board, live in Home Assistant: local, realtime and ready for automations.
HomeDarts for Autodarts brings your Autodarts board into Home Assistant: darts appear a fraction of a second after they land, straight from the Board Manager in your network. Any other dartboard plays along too, with its darts entered by hand or sent by a Granboard. 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.
HomeDarts for Autodarts is an unofficial community project, not affiliated with Autodarts. Up to version 1.18 it was called Autodarts: From Autodarts to HomeDarts explains the new name and how HomeDarts takes over your boards.
Install with 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 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, Wild Mouse, Random and Hidden Cricket, and nine 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, also through Chromecast, 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. Fifteen blueprints: light show, score display, dart and practice callers, highlight photos, reports, alerts, routines, games started and darts entered by voice, and answers from Assist about your darts.
-
Tournaments and a bot
Tournaments of three to 32 players, as a round robin with a table, a knockout, a double elimination or groups with a knockout, at one board or on several boards at once, 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, and "What is my average today?" gets its answer from the statistics of the board. Any game also starts with one action of an automation.
From the dart to your home¶
Everything happens in your network, in less than a second: the Board Manager names the field, and Home Assistant shows it on the cards and hands it to your automations.
How it compares¶
How HomeDarts compares with the Autodarts app and its browser extension, with darts-caller and darts-wled, and with the other Home Assistant integrations for Autodarts. Coming from another tool shows how to switch.
| Feature | HomeDarts | Autodarts app with Tools for Autodarts | darts-caller and darts-wled | Other Home Assistant integrations |
|---|---|---|---|---|
| Runs without the cloud | Yes, with the local interface of the Board Manager | No, with an Autodarts account | No, darts-caller signs in to Autodarts | Some of them (details) |
| Entities and events in Home Assistant | Yes, an event for every dart, visit, takeout, bust, leg and match | No | No | Sensors of the current visit or game |
| Blueprints | Fifteen blueprints | No | No | No |
| Light show | Light show blueprint, for WLED or any light | WLED, with Tools | WLED, with darts-wled | Your own automations |
| Caller | On the scoreboard or your speakers | In the app, with a premium voice in Plus; more with Tools | Voice packs, with darts-caller | No |
| Statistics kept at home | Yes: averages, heatmaps, profiles and a year of history | No, in the Autodarts account | No | No |
| Without an Autodarts board | Yes, on a keypad or a Granboard over Bluetooth (experimental) | Yes, on a keypad or with Lens | No | No |
| Online matches | Your darts, and the moments of the match through the online bridge (experimental) | Yes | Yes | Some of them, through the cloud |
| License and cost | MIT, free | Autodarts: a free plan and the paid Plus; Tools: CC BY-NC 4.0 | Free, no license stated | MIT, Apache 2.0 or no license file |
As of October 2026, from the documentation and the code of each project. Coming from another tool has the details and the sources.
Guides¶
- From zero to the scoreboard: Home Assistant, HACS, the integration and the first game, for Autodarts players new to Home Assistant
- Installation and setup: requirements, HACS or by hand, the ways to add a board, updates and removal
- Play without Autodarts: any dartboard, with every game, the training and the statistics, the darts entered on a keypad
- Granboard over Bluetooth: the darts of a Granboard over Home Assistant's Bluetooth and ESPHome proxies (experimental)
- Frequently asked questions: the account, devices, online play, privacy, several boards, screens, languages and updates
- Coming from another tool: the other integrations, MQTT bridges, darts-caller, darts-wled and Tools for Autodarts compared, and how to switch
- From Autodarts to HomeDarts: the new name since version 2.0, and how HomeDarts takes over your boards
- Games and rules: every game at a glance, four ways to start one, matches, teams, handicaps, the bull-off and tournaments
- Scoreboard at the board: a tablet or TV next to the board, landscape and portrait, the new game screen, the caller and idle mode
- Statistics and players: sessions, personal bests, heatmaps, where to aim, progress, profiles, achievements and the leaderboard
- Automations: fifteen blueprints, their settings, board events and ready-to-use examples
- Online matches: busts, won legs and matches of online matches as board events, with 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, articles and posts, the creator kit has facts, ready-to-post texts, videos and pictures, free to use.
Supported devices¶
| Setup | 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 | Not tested yet | – |
| Cameras | Any number supported by the Board Manager | 3 |
| Home Assistant | 2026.8 or newer (why) | 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, or with a voice pack of recorded calls;
homedarts.generate_voice_packrecords one in the language you choose. - The documentation is in English and German, the settings of the blueprints in English because Home Assistant does not translate blueprints. Their calls still speak all five languages: the integration gives the events the words of the callers and of the weekly report in the language of Home Assistant (calls in the language of Home Assistant). The voice blueprints understand sentences in all five languages. Assist answers in the language of Home Assistant, and in the language of the question for Ask Assist about your darts.
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. Each language has two small files of its own, translations/<language>.json for the integration and frontend/text/<language>.js for the cards, both in custom_components/homedarts/. To improve a translation or add a language, see translations in CONTRIBUTING.md.