HACS (Home Assistant Community Store) va vous permettre d’augmenter le nombre de matériels intégrables dans Home Assistant, vous aider dans leur installation.
Il permet de mettre le travail de toute une communauté au profit des autres de manière simplifiée, à l’image d’un magasin d’intégration, de cartes, de thèmes et de scripts.
Niveau requis
- Débutant / Intermédiaire / Avancé
Prérequis
- Un compte GitHub.
- Méthode 1 : un accès au Shell de Home Assistant (par ex. avec l’add-on SSH & Web Terminal)
- Méthode 2 : un accès au système de fichier de Home Assistant (par ex. avec l’add-on Samba Share)
Installation
Méthode 1 : installation automatique
Prérequis : pour cette partie il vous faut un accès au Shell de Home Assistant.
Ouvrez une session Shell sur votre Home Assistant et utiliser les commandes suivantes :
sudo -u homeassistant -H -s
wget -q -O - https://hacs.xyz/install | bash -
Vous devriez avoir ceci :
Vous devez redémarrer Home Assistant pour que HACS soit pris en compte.
Méthode 2 : installation manuelle
Prérequis : Pour cette méthode, vous devrez pouvoir déposer l’archive .zip de HACS.
Récupérer la dernière version de HACS
Télécharger le fichier hacs.zip
Une fois téléchargé, décompressez l’archive dans le dossier custom_components(qui se trouve au même niveau que votre fichier de configuration configuration.yaml, si le dossier n’existe pas, créez le).
Vous devriez avoir ceci comme arborescence :
Dans
File Editor, vérifier bien que le dossier custom_components soit bien dans le même répertoire que configuration.yaml.
Redémarrer Home Assistant après avoir vérifié le fichier de configuration.
Configuration
Sur votre Home Assistant, rendez vous dans Configuration, Intégrations puis cliquer sur le bouton + Ajouter l'intégration.
Dans la fenêtre qui s’affiche, rechercher HACS puis cliquer dessus.
SI HACS n’apparait pas dans la liste, vider le cache de votre navigateur (CTRL+SHIFT+R ou CTRL+F5)
Après quelques instants, une fenêtre s’affiche.
Cochez toutes les cases, puis cliquez sur
SOUMETTRE
Copiez le code affiché, puis cliquez sur le lien affiché.
Renseignez le code (vous pouvez cliquer sur le premier cadre à gauche et faire un coller du presse papier), puis cliquez sur
Continue
Cliquez sur
Authorize hacs
Vous pouvez fermer la fenêtre et revenir sur la page d’Home Assistant.
Cliquez sur le bouton Soumettre
HACS est maintenant installé.
Il vous reste à configurer une pièce (ou pas) puis cliquez sur
TERMINER.
Vous retrouvez donc une tuile dédié à HACS dans les intégrations :
Cliquez sur Options pour les afficher.
N’oubliez pas de valider vos choix avec le bouton
SOUMETTRE
Lancer HACS.
Cliquer sur HACS dans la barre latérale.
Au premier démarrage, HACS s’initialise, soyez patient…
Voici la vue, une fois HACS initilisé.
Vous avez maintenant accès à plusieurs intégration et composants d’interface supplémentaires.
HACS Onglets
Dans l’onglet Intégration il faudra cliquer sur le + en bas à droite pour ajouter des intégrations.
HACS Intégrations Repository
HACS Intégrations
Pour la partie Frontend vous avez plus de Repository dés le début.
HACS Frontend Repository
HACS Frontend
Vous voilà maintenant avec l’intégration HACS opérationnel.
N OTA : Si l’icône est verte alors le module est à jour sinon elle sera orange ou rouge. Cela marche pour tous les modules installés avec HACS.
Regardons un peu comment est le module en image.
Ajouter une intégration.
Dans HACS, Intégrations cliquer sur le + puis rechercher l’intégration que vous souhaitez.
HACS Ajout d’une Intégration
Cliquer sur l’intégration voulu puis descendre en bas de la page (après avoir lu les instructions) pour cliquer sur INSTALL THE REPOSITORY IN HACS
HACS Install Repository
HACS sélection de la version
Choisir la version qu vous souhaitez installer (la dernière c’est mieux).
Puis cliquer sur INSTALL.
Il vous suffit de suivre les instructions pour ajouter votre matériels.
Installer un Thème.
Cliquer sur Frontend puis sur le thème voulu et sur INSTALL.
Puis encore une fois sur INSTALL.
HACS Ajouter un Thème.
HACS Ajouter Thème 2
Ajouter une custom Card.
Dans HACS, Frontend cliquer sur le + puis rechercher votre carte.
HACS Ajouter une CustomCard
Suivre les étapes pour une intégrations elles sont identiques.
Trucs & astuces
- N’hésitez pas à parcourir la liste Awesome de notre communauté
pour découvrir des integrations ou cartes personnalisées
Conclusion
Vous avez maintenant la possibilité d’ajouter encore plus de matériels via les intégrations de HACS, de custom cards, de thèmes grâce à la formidable communauté de Home Assistant.
Une question, un problème
Annexes
Sources
Suivi des modifications
- 17/02/2021 : Ajout de la méthode automatique @Pozzi
-
02/02/2021 : Passage en article officiel (
) @Clemalex
- 28/12/2020 : Mise à jour de la récupération et de l’intégration, ajout du lien vers la liste Awesome @Clemalex
- 26/06/2020 : Début de mise en forme pour V2 @McFly
- 10/05/2020 : Création de l’article @McFly