Over de cijfers in het integratieoverzicht

Een installatieaantal is het aantal Home Assistant-installaties dat analyses heeft ingeschakeld en het item heeft gemeld. Analyses schakel je zelf in, en het delen van welke integraties in gebruik zijn is daarbovenop nog een aparte keuze, dus het echte aantal installaties ligt hoger. Het overzicht noemt zo’n getal altijd installaties die analysegegevens delen, nooit een aantal huishoudens of mensen.

Elk item met een installatieaantal wordt uit dezelfde groep geteld, dus als het ene hoger staat dan het andere, is dat een eerlijke vergelijking, ook al is geen enkel aantal volledig. Dashboardkaarten en thema’s sturen helemaal geen analysegegevens. Ze tonen in plaats daarvan GitHub-sterren en worden onderling op sterren gerangschikt.

Een ingebouwde integratie krijgt de eerste categorie die Home Assistant in de code vermeldt, als die er een vermeldt. Elk ander item volgt de eigen regels van het overzicht: het wordt ingedeeld op naam, anders op de soorten apparaten die het toevoegt, anders op de beschrijving.

Een integratie staat alleen onder haar hoofdcategorie, dus geen enkele lijst toont haar twee keer. Dashboardkaarten, thema’s en apps staan onder geen enkele categorie, en integraties die in geen categorie passen of die Home Assistant zelf instelt ook niet.

Een categorie met 5 items of meer krijgt een eigen pagina, gerangschikt op installaties die analysegegevens delen. De kleinere worden op de categoriepagina genoemd, met hun aantallen.

De screenshots van Marketplace-integraties, dashboardkaarten en thema’s zijn gekopieerd uit de eigen README van elk project, maximaal drie per item. Bij elke screenshot staan een vermelding van de repository en een link naar de plek waar hij gevonden is, en hij blijft eigendom van de auteur.

Ze worden geleverd vanaf vulpo.app, dus de browser van een bezoeker maakt nooit contact met GitHub om ze te tonen. Wil je een screenshot, of elke afbeelding van een repository, laten verwijderen, vraag het dan via de contactpagina op /contact. Het verzoek komt op een lijst waar elke latere update zich aan houdt, zodat de screenshot niet terugkomt.

Logo’s en pictogrammen zijn van hun eigenaars en worden alleen getoond om aan te geven welk item het is. De pictogrammen van ingebouwde en Marketplace-integraties komen uit de brands-repository van Home Assistant, dat van een app uit de eigen repository, en dat van een dashboardkaart of thema wordt uit de eerste screenshot geknipt.

Net als de screenshots worden ze geleverd vanaf vulpo.app, en een pictogram wordt op verzoek verwijderd via de contactpagina op /contact.

Elke beschrijving is een automatische samenvatting, geschreven door Claude, een AI-model van Anthropic, op basis van de eigen bronnen van het item: de broncode van Home Assistant voor een ingebouwde integratie, en de code en README van het project voor al het andere. Op de Nederlandse pagina’s is elke beschrijving bovendien automatisch door Claude vertaald. Een README wordt alleen gebruikt als de licentie hergebruik toestaat. De documentatie van Home Assistant wordt nooit gebruikt. Voordat een beschrijving wordt gepubliceerd, controleren vaste regels of ze alleen dingen noemt die in de bronnen staan en zich nooit als officieel voordoet. Niemand controleert elke beschrijving met de hand, dus er kan een fout doorheen glippen. Meld een fout via de contactpagina op /contact. De maintainer van een project kan op dezelfde manier een eigen tekst sturen, en die vervangt de samenvatting.

Op de pagina van een ingebouwde integratie zijn de instelvelden, entiteitsnamen, acties en reparatiemeldingen de eigen teksten van Home Assistant, gelezen uit de release op PyPI onder de Apache License 2.0. Die van een Marketplace-integratie komen uit de eigen repository. Als een repository geen licentie heeft die hergebruik toestaat, worden alleen de namen getoond. Teksten waarvoor Home Assistant of een repository geen Nederlandse vertaling heeft, zijn automatisch door Claude vertaald.

De pagina van een Marketplace-item of app kan het begin van de README of documentatie en de lijst met functies citeren, ingekort en zonder afbeeldingen of opmaak, als de licentie van de repository hergebruik toestaat. Het citaat noemt de licentie en linkt naar het volledige bestand. Wil je een fragment of een beschrijving laten verwijderen, vraag het dan via de contactpagina op /contact. Het verzoek komt op een lijst waar elke latere update zich aan houdt.

De gegevens worden één keer per dag opgehaald en de site wordt daaruit opnieuw opgebouwd, dus een pagina kan tot een dag achterlopen. Als een bron niet bereikbaar is, blijven de laatste goede gegevens van die bron staan en zegt de tabel hieronder dat, met de datum van die gegevens.

De tabel toont elke bron, of het laatste ophalen gelukt is en wanneer de gegevens voor het laatst zijn opgehaald, in UTC.

Dit overzicht is onafhankelijk. Het wordt gemaakt door de ontwikkelaar van Vulpo, een Home Assistant-app voor iPhone, iPad en Mac, en is niet gelieerd aan Home Assistant of de Open Home Foundation.

Of Vulpo een item ondersteunt, speelt geen rol in de rangschikking.

Is een merk verkeerd gegroepeerd, staat een item in de verkeerde categorie of is een gegeven verouderd, stuur het dan via de contactpagina op /contact.

Verzoeken om een screenshot of pictogram te verwijderen gaan op dezelfde manier, en elke verwijdering blijft op een lijst staan waar elke latere update zich aan houdt.

Fragmenten en beschrijvingen kunnen op dezelfde manier worden verwijderd.