HomeDarts for Autodarts
Your Autodarts board, live in Home Assistant: local, realtime and ready for automations.
Documentation · Try it live · Deutsche Anleitung · Nederlands · Français · Español · Quick start · Changelog · 💛 Sponsor
HomeDarts for Autodarts brings your Autodarts board into Home Assistant: every dart, live from the Board Manager in your network. Any other dartboard plays along too, with its darts entered by hand or sent by a Granboard. 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.
Try the cards live in your browser: a 501 against the bot, a Cricket game and a tournament, played by the integration at a simulated board and shown by its cards, on a phone too and in all five languages. Nothing to install.
Quick start
You need Home Assistant 2026.8 or newer with HACS, and an Autodarts board in your network or any dartboard whose darts you enter on a keypad (requirements).
-
Install with HACS, then restart Home Assistant.
Or open HACS in Home Assistant, search for HomeDarts and select Download.
-
Add your board. With Board Manager 2, Home Assistant usually shows it under Settings → Devices & services → Discovered already. Otherwise:
Choose Search for boards on this network or Enter board address and confirm. Without Autodarts, choose Dartboard without Autodarts: enter every dart yourself.
-
Add the cards. Create a complete dashboard in one step: Settings → Dashboards → Add dashboard → HomeDarts. Or edit a dashboard, choose Add card and search for HomeDarts.
New to Home Assistant? From zero to the scoreboard takes you from nothing to the scoreboard next to your board. The installation guide covers manual installation, reconfiguration, updates and removal.
Coming from Autodarts Local, another integration for Autodarts or darts-caller? Coming from another tool shows what takes their place and how to switch. Short answers to the common questions are in the FAQ.
Why
- Instant and local. Darts appear in Home Assistant a fraction of a second after they land, straight from the Board Manager in your network. No account, no cloud, no client ID.
- A whole darts evening. X01 from 101 to 1001, six Cricket games, nine party games and eight training games, alone, as a match of up to four, a party game of up to eight or a tournament of up to 32, with a scoreboard for the tablet at the board.
- Your progress in numbers. Averages, heatmaps of the real dart positions, where to aim with your own spread, personal bests, badges, weekly trends, player profiles, a weekly report and a year of history, all kept in your home.
- Your home plays along. Lights for a 180, a caller on your speakers, the board light for the takeout, a photo of your best checkout.
Features
Play · Like a dart machine · Train · Analyze · Screen at the board · Automate · Local and private
Play
- X01 from 101 to 1001 with straight, double and master in and out, the 50/50 bull, a round limit and the checkout route after every dart
- Cricket, Cut-Throat Cricket, Tactics, Wild Mouse, Random Cricket and Hidden Cricket on a chalkboard
- Party games for up to eight: Shanghai, Halve-It, Killer, Golf, Baseball, Count-Up, Bermuda, Round the World and Gotcha
- Tournaments of three to 32 players: a round robin with a table, a knockout, a double elimination or groups with a knockout, with their brackets, at one board or on several boards at once
- Matches of up to four players with legs and sets, two teams of two, handicap start scores and a bull-off, and a summary of every match
- A bot from level 20 to 120 to play X01 and Cricket against
- A tap corrects a dart the board read wrong; a keypad enters darts by hand, and the last visit can be undone
- No Autodarts? Any dartboard plays along, with every dart entered on the keypad
- Setup hints where no checkout is possible, such as T20 T20 S17 to leave 32
Games and rules →
Like a dart machine
- Wild Mouse, also known as Minnesota Cricket, with doubles, triples and three in a bed
- Random Cricket with new numbers every leg, and Hidden Cricket, whose numbers show only once a dart finds them
- Aim hints on the chalkboard: green where a dart scores, amber what to close, and a dart that counted nothing struck through
- Confetti and a golden glow for a 180, a game shot and the match, a glow for a ton
- How to play every game on the new game screen, for guests who never played it, and party games for up to eight players
Wild Mouse →
Train
- Training sessions that start with the first dart and keep your last 20 sessions
- Eight training games: Around the Clock, doubles training, checkout training, Bob's 27, the 121 checkout, Catch 40, the JDC Challenge and the singles training
- A daily goal, a training streak and personal bests with an event when you beat one
Training games →
Analyze
- 3-dart average, first 9 average, checkout and doubles rate
- A heatmap of every bed or of the real dart positions, with the grouping in millimeters
- An aim map: where each player scores the most points per dart with their own spread, the treble 20, the treble 19 or a spot near the bull
- Player profiles with badges in bronze, silver, gold and platinum, and a leaderboard; a profile is renamed with all its numbers, and two names of one player merge into one
- Weekly trends, head-to-head records and the match history of every player
- The hit rate of every double, a weekly report, a training calendar and exports to CSV or JSON
- A backup of every board before it is deleted, which a board added again restores, and the players of two boards merged into one
- Long-term statistics for graphs over weeks and months
Statistics and players →
Screen at the board
- A scoreboard for a tablet or TV, also through Chromecast, readable from the oche, with a full-screen button that keeps the screen on
- A new game screen to choose the game, the players and the format at the board, or to start a tournament
- A caller that calls the game through the screen's browser, also with the recorded voice packs of darts-caller or a voice you record with Piper, and for blind and low-vision players every dart, the checkout route and the next target
- Idle mode with a leaderboard, personal bests, today's darts and a clock
- A stream overlay for OBS: the score, the route and the visit over the picture of your stream, see-through or on a key colour
Scoreboard at the board →
Automate
- Board events for every dart, visit, takeout, bust, won leg and match, the start and end of every game, personal best and more
- Sixteen blueprints: light show, walk-on music, 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, which come with the integration and update with it (see them)
- Start any game with one action, also by voice, tell Assist your darts, as at a dart machine, and ask it "What is my average today?"
- Online matches on play.autodarts.io through an optional bridge (experimental)
Automations →
Local and private
- 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; board secrets are never stored
- Seven dashboard cards and an automatic dashboard, in English, German, Dutch, French and Spanish (languages)
- Light on a Raspberry Pi: a message of the board updates only the entities that show what changed (data updates)
- Every rule of the Home Assistant quality scale up to Platinum, 100 % test coverage
How it works →
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:
| 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 | Sixteen 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 |
As of October 2026, from the documentation and the code of each project. Coming from another tool has the details, the sources and how to switch.
Requirements
Home Assistant 2026.8 or newer with HACS, and an Autodarts board in your network, or any dartboard whose darts you enter on a keypad (play without Autodarts), or a Granboard within reach of Home Assistant's Bluetooth (Granboard, experimental). No Autodarts account is needed.
- Board Manager 2, Autodarts 2 without a screen, is recommended and tested up to 2.0.2; the classic Board Manager 1 works too.
- A player reports that Autodarts Desktop 2.0.2 on Linux works too.
- Autodarts Desktop on Windows and Winmau Autodarts devices such as Autodarts X have not been tested yet; a compatibility report helps, whether it works or not.
Blueprints
The integration brings every blueprint along and keeps those you haven't changed up to date with each of its updates. Choose one on the blueprints page of Home Assistant, select your board and you're done; the buttons import one from GitHub, for example one you deleted.
-
Light show. Your WLED presets or room lights for a 180, a high finish, a bust, a won leg or match, a personal best, an achievement, the winner of a tournament and more, and back to your normal light afterwards.
-
Walk-on music. The walk-on song of every player when a game starts, like on stage, until the first dart, and the song of the winner after the match.
-
Dart caller. Every visit announced on your speakers, with a special call for 180, in the language of Home Assistant or with the recorded sounds of a voice pack.
-
Highlight photo. A picture of the board after a 180 or a checkout, on your phone and in a gallery of the media browser, and with a camera of the room a clip from a few seconds before the dart.
-
Celebrate a visit score. Your actions for every 180, every ton, or any score you choose, the moment the third dart lands.
-
Practice caller. Who needs what, busts and game shots of the practice game on your speakers, in the language of Home Assistant.
-
Score display. The score of the practice game after every dart, its checkout route, a 180 and the winner on an AWTRIX 3 or a PixelIt at the board.
-
Takeout actions. Light up the board while you pull your darts.
-
Start and stop detection automatically, based on presence in the darts room.
-
Training session routine. Light, detection and calibration follow your training sessions.
-
Weekly report. Your training week with the trend of your 3-dart average, as a notification in the language of Home Assistant.
Documentation
Every guide is on the documentation website, in English and German, with a search. The start page, the quick start, the installation and the frequently asked questions are also in Dutch, French and Spanish.
Get started
- From zero to the scoreboard: for Autodarts players without Home Assistant, from nothing to the first game on the scoreboard
- Installation: requirements, HACS and manual installation, the ways to add a board, updates and removal
- Play without Autodarts: any dartboard with every game, the training and the statistics, its darts entered on a keypad
- Granboard over Bluetooth: the darts of a Granboard over Home Assistant's Bluetooth and ESPHome proxies, for every game (experimental)
- Frequently asked questions: account, devices, online play, privacy, several boards, screens, languages, updates and switching, in short answers
- Coming from another tool: Autodarts Local, the other integrations, MQTT bridges, darts-caller, darts-wled and Tools for Autodarts compared, and how to switch
- From Autodarts to HomeDarts: why the integration has a new name since version 2.0, and how HomeDarts takes over the boards you set up under the old one
Guides
- Games and rules: how to start a game, matches, teams, handicaps, the bull-off, the match summary, tournaments and the rules of every game
- Scoreboard at the board: a tablet or TV at the board, the new game screen, tournaments, the caller and idle mode
- Statistics and players: sessions, personal bests, heatmaps and dart positions, where to aim, doubles, player profiles, achievements, trends, the leaderboard, reports, calendar, export and backups
- Automations: sixteen blueprints, board events and ready-to-use examples
- Online matches: moments of online matches on play.autodarts.io in Home Assistant (experimental)
Reference
- Dashboard cards: all seven cards, the automatic dashboard, every option and accessibility
- Entities and events: every entity, event, attribute and action
- How it works: data flow, update intervals, connection behavior, stored data and privacy
- Troubleshooting: messages, repairs, diagnostics and logs
- Security design: what is protected, trust boundaries, threats and countermeasures
- Glossary: the words of darts and of this integration, in English and German
Project
Known limitations
- No cloud match data. Autodarts issues no client IDs to third-party integrations, so there is no cloud link; everything works with the Board Manager in your network.
- Online matches through a browser extension. Busts and game shots of online matches arrive only while the Autodarts page is open with Tools for Autodarts, a third-party extension. Limitations.
- Training sessions count darts, not games. A session counts every dart the board detects; players, legs and checkouts belong to the practice game, which keeps its own statistics.
- Board Manager updates are installed on the board PC. The update entity reports new Board Manager 2 versions.
- Live camera view with Board Manager 2 only. With Board Manager 1, the camera entities show snapshots.
Support and contributing
- Questions and ideas: the FAQ answers the common ones; ask the rest in GitHub Discussions. Bugs: issues, with the diagnostics of your board. SUPPORT.md explains where to ask what.
- Tried it? A tester report tells us what worked, what didn't and what you miss; short answers are fine.
- Speak German, Dutch, French or Spanish? The translation issues name the texts that are missing or outdated in your language, and how to fix them in the browser, no programming needed.
- Security: report vulnerabilities privately as described in SECURITY.md.
- Show your board: post a photo of your board, the screen next to it and what Home Assistant does with it in Show and tell. It gives others ideas and shows them that the integration runs at boards like theirs.
- Show it: for videos, articles and posts, the creator kit has facts, ready-to-post texts, videos and pictures, free to use.
- Contributing: contributions are welcome; CONTRIBUTING.md explains the checks. Participation follows the and the project's .
Quality and security
- Meets every rule of the Home Assistant integration quality scale up to Platinum (self-assessment), including strict typing.
- 100 % line and branch coverage of the integration, fuzzed cards, a Docker end-to-end test against both Board Manager generations and the oldest supported Home Assistant, a real browser test of every card, and weekly mutation tests of the game rules. Development.
- Signed release packages with SLSA provenance. Releases.
- CI jobs that reach only the hosts they need: Harden-Runner blocks every other one, the bots that may write reach GitHub alone, and the Home Assistant under test stays off the internet. Development.
Credits and license
HomeDarts started as a fork of Trkal/HACSAutodarts, a cloud-based prototype from April 2026. Since September 2026 it has been rewritten and is maintained independently by @Dennis-Otto: local realtime control for both Board Manager generations, games, training analytics, dashboard cards, blueprints, tests and documentation. Up to version 1.18 it was called Autodarts and shared the domain autodarts with the original; since 2.0 it has the domain homedarts, so both can be installed side by side, and the installation guide explains how to switch. Thanks to Trkal for the original work and to the Autodarts team for their open local API.
Licensed under the MIT license. The license covers the icon too. The names Autodarts and Winmau belong to their respective owners. HomeDarts for Autodarts is an unofficial community project, not affiliated with Autodarts.
