À propos des chiffres de l’annuaire des intégrations

Un nombre d’installations est le nombre d’installations Home Assistant qui ont activé les statistiques d’utilisation et signalé l’élément. Les statistiques sont volontaires, et partager la liste des intégrations utilisées demande une seconde activation en plus : le nombre réel d’installations est donc plus élevé. L’annuaire présente toujours ces nombres comme des installations partageant leurs statistiques, jamais comme un nombre de foyers ou de personnes.

Tous les éléments qui ont un nombre d’installations sont comptés dans le même ensemble : qu’un élément soit classé au-dessus d’un autre reste donc une comparaison juste, même si aucun nombre n’est complet. Les cartes de tableau de bord et les thèmes n’envoient aucune statistique. Ils affichent leurs étoiles GitHub à la place et sont classés entre eux par nombre d’étoiles.

Une intégration native prend la première catégorie que Home Assistant indique dans son code, s’il en indique une. Tout autre élément suit les règles propres à l’annuaire : il est placé d’après son nom, à défaut d’après les types d’appareils qu’il ajoute, à défaut d’après sa description.

Une intégration n’apparaît que dans sa catégorie principale : aucune liste ne la répète. Les cartes de tableau de bord, les thèmes et les applications n’apparaissent dans aucune, pas plus que les intégrations qui n’entrent dans aucune catégorie ou que Home Assistant configure de lui-même.

Une catégorie de 5 éléments ou plus a sa propre page, classée par nombre d’installations partageant leurs statistiques. Les plus petites sont citées sur la page des catégories avec leur nombre d’éléments.

Les captures d’écran des intégrations, des cartes de tableau de bord et des thèmes de la Marketplace sont copiées depuis le README de chaque projet, jusqu’à trois par élément. Chacune mentionne son dépôt, renvoie vers l’endroit où elle a été trouvée et appartient à son auteur.

Elles sont servies depuis vulpo.app : pour les afficher, le navigateur ne contacte donc jamais GitHub. Pour faire retirer une capture, ou toutes les images d’un dépôt, fais-en la demande via la page de contact, /contact. La demande rejoint une liste que chaque mise à jour suivante respecte, et l’image ne revient donc pas.

Les logos et les icônes appartiennent à leurs propriétaires et ne servent qu’à identifier chaque élément. Les icônes des intégrations natives et de la Marketplace viennent du dépôt brands de Home Assistant, celle d’une application de son propre dépôt, et celle d’une carte de tableau de bord ou d’un thème est découpée dans sa première capture d’écran.

Comme les captures d’écran, elles sont servies depuis vulpo.app, et une icône est retirée sur simple demande via la page de contact, /contact.

Chaque description est un résumé automatique, rédigé par Claude, un modèle d’IA créé par Anthropic, à partir des sources propres à l’élément : le code source de Home Assistant pour une intégration native, le code et le README du projet pour tout le reste. Un README n’est utilisé que si sa licence autorise la réutilisation. La documentation de Home Assistant n’est jamais utilisée. Avant la publication d’une description, des règles vérifient qu’elle ne cite que ce que contiennent ses sources et qu’elle ne se présente jamais comme officielle. Personne ne relit chaque description à la main : une erreur peut donc passer. Pour en signaler une, passe par la page de contact, /contact. La personne qui maintient un projet peut envoyer son propre texte de la même façon, et il remplace le résumé. Les descriptions en français sont des traductions automatiques de ces résumés, faites elles aussi par Claude.

Sur la page d’une intégration native, les champs de configuration, les noms d’entités, les actions et les avis de correction sont les textes propres à Home Assistant, lus dans sa version publiée sur PyPI sous l’Apache License 2.0. Ceux d’une intégration de la Marketplace viennent de son propre dépôt. Quand un dépôt n’a pas de licence qui autorise la réutilisation, seuls leurs noms sont affichés. Les textes que Home Assistant ou le dépôt ne fournissent pas en français sont traduits automatiquement par Claude.

La page d’un élément de la Marketplace ou d’une application peut citer le début de son README ou de sa documentation et sa liste de fonctionnalités, abrégés et sans images ni mise en forme, quand la licence du dépôt autorise la réutilisation. La citation indique la licence et renvoie au fichier complet. Pour faire retirer un extrait ou une description, fais-en la demande via la page de contact, /contact. La demande rejoint une liste que chaque mise à jour suivante respecte.

Les données sont récupérées une fois par jour et le site est reconstruit à partir d’elles : une page peut donc avoir jusqu’à un jour de retard. Si une source est injoignable, les dernières données valides de cette source sont conservées, et le tableau ci-dessous l’indique, avec la date de ces données.

Le tableau liste chaque source, indique si sa dernière récupération a réussi et quand les données ont été récupérées pour la dernière fois, en UTC.

Cet annuaire est indépendant. Il est créé par le développeur de Vulpo, une app Home Assistant pour iPhone, iPad et Mac, et n’est affilié ni à Home Assistant ni à l’Open Home Foundation.

Que Vulpo prenne en charge un élément ou non ne joue aucun rôle dans son classement.

Si une marque est mal regroupée, si un élément est dans la mauvaise catégorie ou si une information n’est plus à jour, signale-le via la page de contact, /contact.

Les demandes de retrait d’une capture d’écran ou d’une icône passent par le même chemin, et chaque retrait est conservé sur une liste que chaque mise à jour suivante respecte.

Les extraits et les descriptions peuvent être retirés de la même façon.