Über die Zahlen im Integrationsverzeichnis

Eine Installationszahl ist die Zahl der Home Assistant-Installationen, die die Datenauswertung eingeschaltet haben und den Eintrag melden. Die Datenauswertung ist freiwillig, und das Teilen der genutzten Integrationen braucht eine zweite, eigene Zustimmung, daher liegt die wahre Zahl der Installationen höher. Das Verzeichnis bezeichnet jede solche Zahl als „Installationen, die Analysedaten teilen“, nie als Zahl von Haushalten oder Personen.

Jeder Eintrag mit Installationszahl wird aus demselben Datenbestand gezählt, daher ist der Vergleich zwischen zwei Einträgen fair, auch wenn keine Zahl vollständig ist. Dashboard-Karten und Themes senden überhaupt keine Analysedaten. Bei ihnen stehen stattdessen GitHub-Sterne, und untereinander sind sie nach Sternen sortiert.

Eine eingebaute Integration bekommt die erste Kategorie, die Home Assistant in ihrem Code nennt, sofern es eine nennt. Jeder andere Eintrag folgt den eigenen Regeln des Verzeichnisses: Er wird nach seinem Namen eingeordnet, sonst nach den Gerätearten, die er hinzufügt, sonst nach seiner Beschreibung.

Eine Integration steht nur unter ihrer Hauptkategorie, damit keine Liste sie doppelt zeigt. Dashboard-Karten, Themes und Apps stehen unter keiner, ebenso wenig Integrationen, die in keine Kategorie passen oder die Home Assistant von selbst einrichtet.

Eine Kategorie mit 5 oder mehr Einträgen bekommt eine eigene Seite, sortiert nach Installationen, die Analysedaten teilen. Die kleineren werden auf der Kategorienseite mit ihrer Anzahl genannt.

Die Screenshots von Marketplace-Integrationen, Dashboard-Karten und Themes sind aus der README des jeweiligen Projekts kopiert, bis zu drei pro Eintrag. Jeder Screenshot trägt eine Quellenangabe zu seinem Repository und einen Link zurück zur Fundstelle und gehört seinen Autorinnen und Autoren.

Ausgeliefert werden sie von vulpo.app, sodass kein Browser GitHub kontaktiert, um sie anzuzeigen. Soll ein Screenshot oder jedes Bild eines Repositorys entfernt werden, nutze die Kontaktseite unter /contact. Die Anfrage kommt auf eine Liste, die jedes spätere Update berücksichtigt, damit nichts zurückkommt.

Logos und Symbole gehören ihren Eigentümerinnen und Eigentümern und werden nur gezeigt, um jeden Eintrag zu kennzeichnen. Die Symbole eingebauter Integrationen und von Marketplace-Integrationen stammen aus dem Brands-Repository von Home Assistant, das einer App aus ihrem eigenen Repository, und das einer Dashboard-Karte oder eines Themes wird aus dem ersten Screenshot ausgeschnitten.

Wie die Screenshots werden sie von vulpo.app ausgeliefert, und auf Anfrage über die Kontaktseite unter /contact wird ein Symbol entfernt.

Jede Beschreibung ist eine automatische Zusammenfassung, geschrieben von Claude, einem KI-Modell von Anthropic, aus den eigenen Quellen des Eintrags: aus dem Quellcode von Home Assistant bei einer eingebauten Integration, aus Code und README des Projekts bei allem anderen. Eine README wird nur genutzt, wenn ihre Lizenz die Weiterverwendung erlaubt. Die Dokumentation von Home Assistant wird nie genutzt. Bevor eine Beschreibung erscheint, prüfen Regeln, dass sie nur nennt, was in ihren Quellen steht, und dass sie nie behauptet, offiziell zu sein. Niemand prüft jede einzelne von Hand, daher kann ein Fehler durchrutschen. Um einen zu melden, nutze die Kontaktseite unter /contact. Wer ein Projekt betreut, kann auf demselben Weg einen eigenen Text schicken, und dieser ersetzt die Zusammenfassung. Die deutschen Beschreibungen übersetzt Claude ebenfalls automatisch, aus der englischen Zusammenfassung.

Auf der Seite einer eingebauten Integration sind die Einrichtungsfelder, Entitätsnamen, Aktionen und Reparaturhinweise die eigenen Texte von Home Assistant, gelesen aus seiner Version auf PyPI unter der Apache License 2.0. Bei einer Marketplace-Integration stammen sie aus ihrem eigenen Repository. Wo ein Repository keine Lizenz hat, die die Weiterverwendung erlaubt, werden nur die Namen der Felder, Entitäten und Aktionen gezeigt. Texte, die Home Assistant oder ein Repository nicht auf Deutsch mitliefert, übersetzt Claude automatisch.

Die Seite eines Marketplace-Eintrags oder einer App kann den Anfang ihrer README oder Dokumentation und ihre Funktionsliste zitieren, gekürzt und ohne Bilder oder Formatierung, wenn die Lizenz des Repositorys die Weiterverwendung erlaubt. Das Zitat nennt die Lizenz und verlinkt die vollständige Datei. Soll ein Auszug oder eine Beschreibung entfernt werden, nutze die Kontaktseite unter /contact. Die Anfrage kommt auf eine Liste, die jedes spätere Update berücksichtigt.

Die Daten werden einmal am Tag abgerufen, und die Website wird daraus neu erstellt, daher kann eine Seite bis zu einem Tag hinterherhinken. Ist eine Quelle nicht erreichbar, bleiben die letzten guten Daten dieser Quelle erhalten, und die Tabelle unten vermerkt das mit dem Datum, aus dem sie stammen.

Die Tabelle nennt jede Quelle, ob ihr letzter Abruf erfolgreich war und wann die Daten zuletzt abgerufen wurden, in UTC.

Dieses Verzeichnis ist unabhängig. Es stammt vom Entwickler von Vulpo, einer Home Assistant-App für iPhone, iPad und Mac, und steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Ob Vulpo einen Eintrag unterstützt, spielt für seine Rangfolge keine Rolle.

Ist eine Marke falsch gruppiert, steht ein Eintrag in der falschen Kategorie oder ist eine Angabe veraltet, melde es über die Kontaktseite unter /contact.

Anfragen, einen Screenshot oder ein Symbol zu entfernen, gehen denselben Weg, und jede Entfernung kommt auf eine Liste, die jedes spätere Update berücksichtigt.

Auszüge und Beschreibungen lassen sich auf demselben Weg entfernen.