✅ HACS : Ajoutez des modules et des cartes personnalisées

licence

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.

:arrow_forward: image

Dans la fenêtre qui s’affiche, rechercher HACS puis cliquer dessus.

:information_source: 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

image

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 :

HACS Integrations

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 OngletsHACS 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 RepositoryHACS 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 Theme.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

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

Besoin d'aide ? Cliquez ici !

Annexes

Sources

Suivi des modifications

  • 17/02/2021 : Ajout de la méthode automatique @Pozzi
  • 02/02/2021 : Passage en article officiel (:hacf_tuto: ) @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
1 J'aime

22 messages ont été scindés en un nouveau sujet : Commentaires Article HACS : installation