Name: Tremplin Numérique
Price range: $$$

Home Assistant est une plate-forme de maison intelligente incroyablement puissante, mais ce n'est pas toujours l'expérience la plus conviviale. Comprendre comment modifier la barre latérale afin que je puisse naviguer un peu plus facilement a pris plus de temps que prévu, mais les résultats en valaient la peine.

Voici comment j'ai procédé, pour que vous puissiez le faire aussi.

Cela ne fonctionne que sur les installations supervisées de Home Assistant, ce qui signifie qu'il ne fonctionnera pas sur les installations conteneurisées (Docker) ou Core plus anciennes. Assurez-vous de disposer d'une sauvegarde Home Assistant prête avant de faire trop de bricolage.

Pourquoi s'embêter à faire ça ?

La principale raison pour laquelle je souhaitais modifier la barre latérale de Home Assistant était d'ajouter des raccourcis vers certaines intégrations fréquemment utilisées telles que Zigbee Home Automation (pour accélérer l'ajout et la gestion des appareils) et le module complémentaire « Éditeur de fichiers » (qui est mon moyen préféré de modifier le fichier). configuration.yaml déposer).

L'accès à ces deux éléments nécessite plusieurs clics et nécessite un détour par le menu Paramètres. En même temps, il y a des éléments dans la barre latérale auxquels je n'accède jamais (comme la Carte et l'Énergie). Nous pouvons résoudre ces deux problèmes.

Tant que vous savez où se trouve l'élément pour lequel vous souhaitez créer un raccourci, l'ajout d'un raccourci à la barre latérale (avec une jolie icône personnalisée) est assez simple.

Tout d’abord, ajoutez un module complémentaire d’éditeur de fichiers

Pour ce faire, vous devrez modifier votre fichier principal configuration.yaml fichier, et pour cela, vous aurez besoin d’un module complémentaire. Les modules complémentaires sont des services et des applications supplémentaires qui s'exécutent avec Home Assistant (contrairement aux intégrations qui s'exécutent dans Home Assistant).

Dirigez-vous vers Paramètres > Modules complémentaires et cliquez sur le bouton bleu « Boutique de modules complémentaires » dans le coin inférieur droit de l’écran. Recherchez « Éditeur de fichiers » et sélectionnez-le, puis cliquez sur « Installer ». Attendez la fin de l'installation, puis cliquez sur « Démarrer ». Vous devriez voir un bouton « Ouvrir l'interface utilisateur Web » apparaître, dont vous aurez besoin pour l'étape suivante.

Pendant que vous y êtes, assurez-vous que « Démarrer au démarrage » est activé car ce module complémentaire est particulièrement utile et ne consommera pas trop de ressources.

La façon dont nous ajouterons des éléments de la barre de menus consiste à utiliser l'intégration principale de Home Assistant connue sous le nom de « Panneau personnalisé ». Vous pouvez lire la documentation complète sur le site Web de Home Assistant, mais vous n'avez pas besoin de le faire puisque vous pouvez apprendre et vous adapter en fonction des instructions ci-dessous.

Ajoutons un raccourci vers Zigbee Home Automation et le module complémentaire « Explorateur de fichiers ». Pour ce faire, nous devons savoir où chacun se trouve. Pour ZHA, c'est config/integrations/integration/zha.

J'ai compris cela en accédant à l'intégration et en regardant l'URL dans la barre d'adresse de mon navigateur. Recherchez l'élément pour lequel vous souhaitez créer un raccourci, accédez-y, puis copiez tout après votre serveur et votre numéro de port dans la barre d'URL.

Pour créer un raccourci, cliquez sur le bouton « Ouvrir l'interface utilisateur Web » dans le module complémentaire « Explorateur de fichiers » (Paramètres > Modules complémentaires > Explorateur de fichiers). Une nouvelle interface devrait se lancer avec votre /homeassistant/configuration.yaml fichier ouvert. Si, pour une raison quelconque, vous ne voyez pas ce fichier, assurez-vous d'y accéder à l'aide de la barre de navigation en haut de l'éditeur.

Ajoutez maintenant ce qui suit à votre configuration.yaml sur une nouvelle ligne à la fin :

# Custom Panels
panel_custom:
  - name: Zigbee Home Automation
        sidebar_title: Zigbee Home Automation
        sidebar_icon: mdi:zigbee
        js_url: /api/hassio/app/entrypoint.js
        url_path: config/integrations/integration/zha
        embed_iframe: true
        require_admin: true
        config:
          ingress: core_configurator

Pour ajouter un raccourci vers le module complémentaire « Éditeur de fichiers », j'ai ajouté une autre entrée directement ci-dessous :

  - name: File editor
    sidebar_title: File editor
    sidebar_icon: mdi:pencil
    js_url: /api/hassio/app/entrypoint.js
    url_path: hassio/addon/core_configurator/info
    embed_iframe: true
    require_admin: true
    config:
      ingress: core_configurator

Les seuls champs que vous devez modifier lors de cette opération sont :

name — le nom de l'élément que vous ajoutez
sidebar_title — le nom que vous voulez voir dans la barre latérale
sidebar_icon — l'icône que vous souhaitez afficher à côté de l'icône
url_path – l'emplacement de l'élément vers lequel vous créez un raccourci

Pour l’icône, Home Assistant utilise le jeu d’icônes Material Design. Recherchez simplement une icône que vous souhaitez utiliser, puis assurez-vous d'utiliser le format mdi:name pour l'afficher correctement.

Tant que vous emboîtez de nouveaux éléments sous le panel_custom ligne, vous pouvez continuer à créer des raccourcis.

Pour appliquer votre modification, cliquez sur le bouton rouge « Enregistrer » en haut de l'écran. Redémarrez maintenant Home Assistant (via le menu Paramètres, cliquez sur les trois points dans le coin supérieur droit de l'écran, puis choisissez « Redémarrer Home Assistant ») pour voir vos modifications.

Pour supprimer une icône, vous pouvez toujours supprimer le YAML associé dans votre configuration.yaml déposer. Alternativement, vous pouvez masquer les icônes et modifier l'ordre dans lequel elles apparaissent à l'aide d'un menu simple.

Pour y accéder, cliquez sur votre nom ou sur l'icône d'utilisateur dans le coin inférieur gauche de l'écran et faites défiler vers le bas jusqu'à ce que vous voyiez « Modifier l'ordre et masquer les éléments de la barre latérale ».

Cliquez sur « Modifier » et vous verrez toute une liste d'éléments, y compris ceux que vous avez ajoutés vous-même. Cliquez et faites glisser jusqu'à ce que vous soyez satisfait, puis cliquez sur « Enregistrer ».

Laisser la barre latérale de votre Home Assistant dans un état par défaut moins qu’optimisé est une erreur. Découvrez quelles autres erreurs Home Assistant vous devriez éviter.