Instalación y configuración

Esta página describe la instalación y cómo añadir una diana. La reconfiguración, el paso a Board Manager 2, la actualización desde la versión 1.x, el cambio desde la integración original y la eliminación están en la página en inglés.

Requisitos

Requisito	Detalles
Home Assistant	2026.8 o posterior (por qué 2026.8, en inglés)
Diana Autodarts	Instalada y funcionando en el Board Manager de Autodarts: Board Manager 2, Autodarts 2 sin pantalla (headless, recomendado, probado hasta la versión 2.0.2), o el Board Manager 1 clásico. Según un jugador, Autodarts Desktop 2.0.2 en Linux también funciona. Autodarts Desktop en Windows y los dispositivos de Winmau como Autodarts X o Lens aún no se han probado; cuéntanos cómo funciona con el tuyo
Red	Home Assistant llega al PC de la diana en la red local, por defecto en el puerto TCP 3180
Sin Autodarts	Cualquier diana: introduces los dardos en un teclado numérico, consulta Play without Autodarts; no necesita ni un PC en la diana ni una red hasta la diana

La integración no necesita usuario de Autodarts, contraseña ni clave de API. Nunca cambia el registro de tu diana en Autodarts. Tampoco tiene enlace con la nube de Autodarts: Autodarts no da ID de cliente a integraciones de terceros (decisión 0025, en inglés).

Instalar

Con HACS (recomendado)

1. Elige el botón de arriba, o abre HACS en Home Assistant, busca HomeDarts y ábrela.
2. Elige Descargar.
3. Reinicia Home Assistant.

HACS muestra las versiones nuevas como una actualización en Ajustes → Actualizaciones. La ventana de la actualización muestra las notas de la versión. HACS instala el paquete firmado homedarts.zip, el mismo archivo que en una instalación a mano.

La integración está entre los repositorios por defecto de HACS desde el 20 de octubre de 2026 (hacs/default#11306). Si antes la añadiste como repositorio personalizado, no tienes que hacer nada: HACS ya no la muestra entre los repositorios personalizados y conserva tu instalación y sus actualizaciones.

¿Quieres probar las betas? Betas for testers explica cómo las ofrece HACS.

A mano

1. Descarga homedarts.zip de la última versión en GitHub. Contiene los archivos de la integración, sin una carpeta alrededor.
2. Crea la carpeta custom_components/homedarts en tu configuración de Home Assistant y descomprime allí el archivo. El resultado es config/custom_components/homedarts/manifest.json.
3. Reinicia Home Assistant.

El flujo de publicación firma cada paquete: gh attestation verify homedarts.zip --repo Dennis-Otto/homedarts-for-autodarts comprueba con la GitHub CLI que se construyó a partir de este repositorio, consulta signed release packages.

Añadir tu diana

Hay tres formas de añadir una diana Autodarts. Todas terminan en la misma diana, totalmente local. Una cuarta añade una diana sin Autodarts.

Qué forma encaja con tu diana:

1. Descubrimiento automático (Board Manager 2)

Board Manager 2 se anuncia en la red (mDNS, _autodarts-board._tcp). Home Assistant muestra entonces Diana Autodarts encontrada en Ajustes → Dispositivos y servicios → Descubierto. Elige Añadir y confirma. La ventana indica la dirección, la versión del Board Manager y el número de cámaras.

Si la diana recibe más tarde una nueva dirección IP, el anuncio actualiza solo la dirección configurada.

2. Buscar dianas en esta red

Elige Buscar dianas en esta red. La integración pregunta al servicio público de descubrimiento de Autodarts, que también usa la aplicación Board Manager, qué dianas están registradas desde tu conexión a internet. Elige tu diana, y la integración se conecta a ella en local. La entrada y el dispositivo toman el nombre que la diana tiene en Autodarts.

El servicio de descubrimiento ve tu dirección IP pública, como cualquier sitio web. No se envía nada más. Si el servicio no está disponible o no encuentra ninguna diana nueva, se abre en su lugar el formulario de la dirección.

3. Introducir la dirección de la diana

Elige Introducir la dirección de la diana e introduce la dirección IP o el nombre de host del PC de la diana, por ejemplo 192.0.2.10 o autodarts.local, sin http:// y sin puerto. El puerto es normalmente 3180.

La integración lee el ID de la diana del Board Manager. Rechaza las direcciones a las que no llega o que aún no tienen una diana configurada.

Consejo: dale al PC de la diana una dirección IP fija en tu router. Con Board Manager 2, el descubrimiento mantiene la dirección al día de todos modos.

4. Una diana sin Autodarts

Elige Diana sin Autodarts: introduce tú cada dardo y dale un nombre a la diana, como Garaje. Introduces sus dardos en el teclado numérico de la tarjeta en directo y del marcador, y los juegos, el entrenamiento y las estadísticas funcionan como con Autodarts; Play without Autodarts lo explica todo. Una casa puede tener varias, junto a dianas Autodarts, y cada una puede recibir más tarde su diana Autodarts.

Después de la configuración

Home Assistant crea un dispositivo, con el nombre de tu diana, con todas las entidades. Para un panel con todo, ve a Ajustes → Paneles de control → Añadir panel de control → HomeDarts, como dice la ventana al final de la configuración: el panel automático construye sus vistas a partir de tus dianas. En un panel propio, Añadir tarjeta encuentra las tarjetas cuando buscas HomeDarts; consulta la guía de las tarjetas.

De cero al marcador sigue con el marcador en una tableta y tu primera partida.