Dams_Wiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
===== Installer Home Assistant Community Store (HACS) =====

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 [[https://hacs.xyz/ | 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).


=== Création d'un compte GitHub ===

HACS utilise l’API de GitHub pour lister les add-on et récupérer les informations de ces derniers :
  - mise à jour
  - bugs
  - 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.

=== Récupérer un Token développeur ===

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.

{{:git1.png?nolink&200|}}

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

{{:git2.png?nolink&200|}}

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

{{:git3.png?nolink&700|}}

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

{{:git4.png?nolink&700|}}

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.__

{{:git5.png?nolink&600|}}

=== Installer l’extension HACS pour Home Assistant ===

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 [[https://github.com/custom-components/hacs/releases/latest | page]].

{{:git6.png?nolink&700|}}

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.__

{{:git7.png?nolink&600|}}

=== Ajouter l’intégration (extension) HACS à Home Assistant ===


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

{{:git8.png?nolink&600|}}

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.

{{:git9.png?nolink&300|}}

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

{{:git10.png?nolink&300|}}

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**

{{:git11.jpg?nolink&300|}}

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

{{:git12.png?nolink&300|}}

__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.__

=== Installer des composants avec HACS ===

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.

{{:git13.png?nolink&800|}}
Dams_Wiki

Outils pour utilisateurs

Outils du site

Outils de la page
