Installation et configuration

Cette page décrit l'installation et l'ajout d'une cible. La reconfiguration, le passage à Board Manager 2, la mise à jour depuis la version 1.x, le passage depuis l'intégration d'origine et la suppression sont sur la page en anglais.

Configuration requise

Élément	Détails
Home Assistant	2026.8 ou plus récent (pourquoi 2026.8, en anglais)
Cible Autodarts	Installée et en état de marche dans le Board Manager d'Autodarts : Board Manager 2, Autodarts 2 sans écran (headless, recommandé, testé jusqu'à la version 2.0.2), ou le Board Manager 1 classique. Selon un joueur, Autodarts Desktop 2.0.2 sous Linux fonctionne aussi. Autodarts Desktop sous Windows et les appareils de Winmau comme Autodarts X ou Lens n'ont pas encore été testés ; dites-nous comment cela se passe avec le vôtre
Réseau	Home Assistant atteint le PC de la cible sur le réseau local, par défaut sur le port TCP 3180
Sans Autodarts	N'importe quelle cible : vous saisissez les fléchettes sur un pavé numérique, voir Play without Autodarts ; il ne faut alors ni PC de la cible ni réseau vers la cible

L'intégration n'a besoin d'aucun identifiant Autodarts, mot de passe ni clé d'API. Elle ne modifie jamais l'enregistrement de votre cible auprès d'Autodarts. Elle n'a pas non plus de lien avec le cloud d'Autodarts : Autodarts ne délivre pas d'identifiants client aux intégrations tierces (décision 0025, en anglais).

Installer

Avec HACS (recommandé)

1. Choisissez le bouton ci-dessus, ou ouvrez HACS dans Home Assistant, recherchez HomeDarts et ouvrez-la.
2. Choisissez Télécharger.
3. Redémarrez Home Assistant.

HACS présente les nouvelles versions comme une mise à jour dans Paramètres → Mises à jour. La fenêtre de mise à jour affiche les notes de version. HACS installe le paquet de version signé homedarts.zip, le même fichier que pour une installation manuelle.

L'intégration fait partie des dépôts par défaut de HACS depuis le 20 octobre 2026 (hacs/default#11306). Si vous l'aviez ajoutée avant comme dépôt personnalisé, vous n'avez rien à faire : HACS ne la liste plus parmi les dépôts personnalisés et garde votre installation et ses mises à jour.

Vous voulez tester les bêtas ? Betas for testers explique comment HACS les propose.

À la main

1. Téléchargez homedarts.zip de la dernière version sur GitHub. Il contient les fichiers de l'intégration, sans dossier autour.
2. Créez le dossier custom_components/homedarts dans votre configuration de Home Assistant et décompressez-y le fichier. Le résultat est config/custom_components/homedarts/manifest.json.
3. Redémarrez Home Assistant.

Le workflow de publication signe chaque paquet : gh attestation verify homedarts.zip --repo Dennis-Otto/homedarts-for-autodarts vérifie avec la GitHub CLI qu'il a été construit à partir de ce dépôt, voir signed release packages.

Ajouter votre cible

Il y a trois façons d'ajouter une cible Autodarts. Toutes aboutissent à la même cible, entièrement locale. Une quatrième ajoute une cible sans Autodarts.

Quelle façon convient à votre cible :

1. Détection automatique (Board Manager 2)

Board Manager 2 s'annonce sur le réseau (mDNS, _autodarts-board._tcp). Home Assistant affiche alors Cible Autodarts détectée sous Paramètres → Appareils et services → Découverts. Choisissez Ajouter et confirmez. La fenêtre indique l'adresse, la version du Board Manager et le nombre de caméras.

Si la cible reçoit plus tard une nouvelle adresse IP, l'annonce met à jour automatiquement l'adresse configurée.

2. Rechercher des cibles sur ce réseau

Choisissez Rechercher des cibles sur ce réseau. L'intégration demande au service de découverte public d'Autodarts, que l'application Board Manager utilise aussi, quelles cibles sont enregistrées depuis votre connexion internet. Choisissez votre cible, et l'intégration s'y connecte en local. L'entrée et l'appareil prennent le nom que la cible porte chez Autodarts.

Le service de découverte voit votre adresse IP publique, comme n'importe quel site web. Rien d'autre n'est envoyé. Si le service n'est pas disponible ou ne trouve aucune nouvelle cible, le formulaire d'adresse s'ouvre à la place.

3. Saisir l'adresse de la cible

Choisissez Saisir l'adresse de la cible et saisissez l'adresse IP ou le nom d'hôte du PC de la cible, par exemple 192.0.2.10 ou autodarts.local, sans http:// et sans port. Le port est normalement 3180.

L'intégration lit l'identifiant de la cible dans le Board Manager. Elle refuse les adresses injoignables ou sans cible configurée.

Astuce : donnez au PC de la cible une adresse IP fixe dans votre routeur. Avec Board Manager 2, la détection garde de toute façon l'adresse à jour.

4. Une cible sans Autodarts

Choisissez Cible sans Autodarts : saisir soi-même chaque fléchette et donnez un nom à la cible, comme Garage. Vous saisissez ses fléchettes sur le pavé numérique de la carte en direct et du tableau des scores, et les jeux, l'entraînement et les statistiques fonctionnent comme avec Autodarts ; Play without Autodarts explique tout. Une maison peut en avoir plusieurs, à côté de cibles Autodarts, et chacune peut recevoir plus tard sa cible Autodarts.

Après la configuration

Home Assistant crée un appareil, nommé d'après votre cible, avec toutes les entités. Pour un tableau de bord complet, allez dans Paramètres → Tableaux de bord → Ajouter un tableau de bord → HomeDarts, comme l'indique la fenêtre à la fin de la configuration : le tableau de bord automatique construit ses vues à partir de vos cibles. Sur votre propre tableau de bord, Ajouter une carte trouve les cartes quand vous recherchez HomeDarts ; voir le guide des cartes.

De zéro au tableau des scores continue avec le tableau des scores sur une tablette et votre première partie.