Wat zijn Home Assistant Blueprints?
Een Blueprint is een herbruikbaar sjabloon voor een automatisering, script of template-entiteit. De maker heeft de algemene logica al geschreven en laat bepaalde onderdelen open. Jij vult vervolgens je eigen sensoren, lampen en voorkeuren in. Zo kun je dezelfde oplossing vaker gebruiken zonder telkens opnieuw te beginnen.

Een voorbeeld: een lamp inschakelen wanneer een bewegingssensor beweging detecteert. De Blueprint beschrijft de werking, maar jij kiest bij het aanmaken van de automatisering welke sensor en lamp je wilt gebruiken.
Blueprint of gewone automatisering?
Een gewone automatisering is geschikt voor één specifieke situatie. Een Blueprint is handig wanneer je dezelfde logica op meerdere plekken wilt toepassen of met anderen wilt delen. Iedere automatisering die je vanuit een Blueprint maakt, krijgt eigen instellingen. Een script start een reeks acties wanneer je die aanroept; een scene zet meerdere apparaten in vooraf ingestelde standen.
Een bestaande Blueprint importeren
1. Kies een betrouwbare bron
Je vindt Blueprints op het Home Assistant Community Forum, GitHub en in de officiële documentatie. Lees de beschrijving, controleer wie de maker is en bekijk reacties en wijzigingsgeschiedenis. Een Blueprint kan apparaten bedienen, dus importeer geen YAML van een bron die je niet vertrouwt.
2. Importeer de Blueprint
- Open Instellingen > Automatiseringen en scènes > Blueprints
- Kies Blueprint importeren
- Plak de URL van de Blueprint en bekijk het voorbeeld
- Controleer de inhoud en kies daarna Importeren
3. Maak een automatisering
Open de geïmporteerde Blueprint en kies om een automatisering te maken. Vul de velden in die de maker beschikbaar heeft gesteld, bijvoorbeeld een bewegingssensor, lamp, helderheidsgrens of vertraging. Sla de automatisering op en test hem bewust.
Blueprints bijwerken en aanpassen
Je kunt de invulvelden van een Blueprint later aanpassen. Wil je meer wijzigen dan de maker toestaat, dan kun je bij een automatisering Take control gebruiken. Home Assistant maakt er dan een gewone automatisering van. Deze is daarna niet meer gekoppeld aan de Blueprint en ontvangt dus ook niet automatisch de wijzigingen van de oorspronkelijke versie.
Een geïmporteerde Blueprint kan opnieuw worden geïmporteerd wanneer de maker een update publiceert. Controleer eerst de wijzigingen: een nieuwe versie kan bestaande instellingen overschrijven of anders werken. Maak bij belangrijke automatiseringen een back-up of noteer de configuratie.
Zelf een Blueprint maken
Een Blueprint voor een automatisering wordt als YAML-bestand opgeslagen in de map blueprints/automation. In het bestand beschrijf je de algemene logica en definieer je inputs. Met !input verwijs je naar de waarden die de gebruiker later in de interface selecteert.
Onderstaand fragment toont het principe. Het koppelt een bewegingssensor aan een lamp. Voor dagelijks gebruik moet je nog een passende uitschakelstrategie en eventuele voorwaarden toevoegen.
blueprint:
name: Bewegingssensor schakelt lamp
description: Schakel een lamp in bij beweging.
domain: automation
input:
motion_sensor:
name: Bewegingssensor
selector:
entity:
domain: binary_sensor
device_class: motion
target_light:
name: Lamp
selector:
entity:
domain: light
triggers:
- trigger: state
entity_id: !input motion_sensor
to: "on"
actions:
- action: light.turn_on
target:
entity_id: !input target_light
Veelgemaakte fouten
- Een Blueprint importeren zonder de bron te controleren
- Vergeten verplichte invoervelden te selecteren
- Verwachten dat Take control de koppeling met de Blueprint behoudt
- Een update importeren zonder compatibiliteit te controleren
- Vergeten dat je eerst een automatisering moet aanmaken
Veelgestelde vragen
Waar vind ik Blueprints?
Op het Blueprint Exchange-forum, GitHub en in de officiële documentatie.
Worden mijn automatiseringen automatisch bijgewerkt?
Automatiseringen die gekoppeld blijven aan een Blueprint kunnen de bijgewerkte inhoud gebruiken nadat Home Assistant de automatiseringen opnieuw heeft geladen. Controleer updates altijd voordat je ze toepast.
Officiële documentatie
Lees Blueprints gebruiken en Over Blueprints. Bekijk ook onze handleiding voor automatiseringsproblemen.