Dams_Wiki

HACS (Home Assistant Community Store) est une extension qui permet d’installer très facilement des composants et des thèmes sans avoir besoin de configurer manuellement quoi que ce soit (une fois que l’extension HACS est installé bien évidemment).

L’extension HACS est très bien documentée… mais uniquement en anglais.

Avant de pouvoir profiter de tous les plugins développés par la communauté via HACS, vous aurez besoin d’un compte GitHub (gratuit).

HACS utilise l’API de GitHub pour lister les add-on et récupérer les informations de ces derniers :

1. mise à jour
2. bugs
3. nombre d’étoiles

C’est une bonne chose, mais cela impose aussi de disposer d’un compte utilisateur sur GitHub.

Si vous ne possédez pas encore, rendez-vous sur la page d’accueil, sinon vous pouvez passer à l’étape suivante.

Remplissez les champs obligatoires puis cliquez sur Sign up for GitHub.

N’oubliez d’aller voir dans votre boîte mail pour confirmer celle-ci.

La création d’un compte est gratuite. Si vous faîtes beaucoup de développement d’objets connectés, ce compte vous sera toujours utile.

Une fois que vous disposez d’un compte actif, ouvrez le menu utilisateur située dans le coin supérieur droit de l’écran puis allez sur la page de configuration (settings) de votre compte.

Ouvrez l’onglet Developper Settings (en bas de la barre latérale à gauche de l’écran).

Ouvrez l’onglet Personnal Access Tokens puis Generate New Token pour créer un nouveau jeton d’accès personnel.

Donnez un nom au jeton (token). Inutile de cocher les options.

Descendez jusqu’en bas des options et cliquez sur Generate.

Le jeton ne sera affiché qu’une seule fois à l’écran. Ne fermez pas la page jusqu’à la fin de l’installation de HACS ou notez le quelque part. Vous pouvez créer autant de token que vous le souhaitez, donc pas de panique, si la page est fermée, créez un nouveau token. C’est tout.

Pour installer l’extension HACS, vous aurez besoin d’un accès aux fichiers. Pour ce fait, vous devez d’abord installer et démarrer l’add-on Samba Share.

Ouvrez le dossier config de Home Assistant depuis le “voisinage réseau” sur Windows ou “réseau” sur macOS.

Si le dossier custom_components existe déjà vous pouvez passer à la suite, sinon créer un nouveau dossier nommé custom_components au même niveau que le fichier configuration.yaml.

Téléchargez maintenant le code du projet depuis GitHub en vous rendant sur cette page.

Décompressez l’archive ZIP avec votre logiciel favori puis déplacez le dossier hacs et tout son contenu dans le dossier précédemment créé.

Redémarrer le serveur Home Assistant en allant dans Configuration → Contrôle du Serveur → Redémarrer.

Une fois que HASS a redémarré, allez dans Configuration puis Intégration

Cliquez sur le plus dans le coin inférieur droit de l’écran.

Dans la fenêtre qui s’affiche, saisissez hacs puis cliquer sur la ligne de l’extension pour débuter l’installation.

L’installation dure quelques minutes. A la fin de l’installation, HACS vous demande de saisir votre jeton (Token) GitHub précédemment créé.

Terminez en cliquant sur soumettre. Si tout est correct, vous devez obtenir un message de succès. Vous pouvez associer HACS à une pièce mais ce n’est pas obligatoire. Cliquer enfin sur Terminer

Un nouveau raccourci a été ajouté à la barre latérale.

Au premier démarrage HACS à besoin de quelques minutes pour lister les composants et les thèmes sur GitHub. Ne soyez pas surpris de trouver une liste vide, c’est normal, il faut attendre un peu.

Et voilà, vous pouvez dès maintenant installer des composants (integrations) développés par la communauté Home Assistant plus facilement qu’en passant par le Add-On Store officiel.

C’est tout à fait possible, mais à chaque fois que l’on souhaite installer un add-on, il faut ajouter l’url vers le dépôt GitHub. En plus, on dispose d’un moteur de recherche par mot clé ce qui évite de devoir fouiller un peu partout pour trouver un composant pour un accessoire domotique.