Home Assistant ESP Screens
Home Assistant ESP Screens is een systeem waarmee gebruikers gepersonaliseerde bedieningsschermen kunnen maken voor hun smart home. Het wordt beheerd via de ESP Screen Manager, die de configuratie van tegels en de installatie van ESPHome-firmware rechtstreeks vanuit Home Assistant regelt.
Belangrijkste kenmerken:
- Hardware: Ondersteuning voor specifieke ESP32-modellen zoals de CYD (2,8 inch) en Guition (4 inch).
- Configuratie: Gebruikers kunnen tot 20 tegels over vier pagina's indelen. Er zijn diverse kaarttypes beschikbaar, waaronder klokken, weersvoorspellingen, klimaatbediening, stofzuiger-status en sensor-historie.
- Interface & Bediening: Het systeem beschikt over een configureerbare bovenbalk, standby-instellingen en directe bedieningselementen (zoals +/- knoppen) op bredere tegels.
- Automatisering: Er is een alert-systeem aanwezig waarmee meldingen (zoals een deuurbel) het scherm kunnen wekken en een melding kunnen tonen.
- Integraties: Het systeem ondersteunt AI-integratie via Claude Code voor configuratie via natuurlijke taal.
Installatie en Beheer: De installatie verloopt via de Home Assistant App store. De ESP Screen Manager integreert de ESPHome CLI, waardoor externe tools overbodig zijn. Updates voor tegels en instellingen kunnen direct worden verzonden zonder dat het apparaat volledig opnieuw geflasht hoeft te worden.
Home Assistant ESP Screens
Ondersteunde schermen
| Scherm | Resolutie | Display / Touch |
|---|
| CYD ESP32-2432S028 | 320 × 240 | ILI9341 / resistief XPT2046 |
| Guition ESP32-S3-4848S040 (4 inch) | 480 × 480 | ST7701S RGB / capacitief GT911 |
Let op: Gebruik exact deze bordvarianten; vergelijkbare productnamen kunnen andere controllers of connectoren hebben. Wallbox-relais worden niet aangestuurd.
De firmware en de ingebouwde CLI zijn getest met ESPHome 2026.6.2.
Configuratiemogelijkheden
Tegels en Layout
Je kunt tot twintig tegels configureren, verdeeld over maximaal vier vaste pagina's van elk zes tegels. Je kunt zoeken op entiteit, apparaat of kamer en tegels verslepen om de volgorde te wijzigen.
Per tegel kun je het volgende instellen:
- Een aangepaste naam.
- Klikgedrag.
- Een kleine schuifregelaar (waar ondersteund).
- Een grote waarde voor zaken als temperatuur en energieverbruik.
- Vanaf firmware 0.2.13: De grote waarde toont een klein domein-icoon naast de titel. Te lange getallen worden afgebroken met een beletselteken (...), terwijl de eenheid zichtbaar blijft.
- Pastelkleurige achtergronden: Kies bijvoorbeeld rood voor een 'alles-uit' script, groen voor 'alles-aan', of een andere kleur. De titel en status blijven donker en leesbaar. De kleur is ook zichtbaar in de schermvoorvertoning. De optie 'Default' herstelt de normale kleuren. De optie 'None' verwijdert de kaart volledig, waardoor de inhoud direct op de achtergrond van het scherm staat (firmware 0.2.16).
Specifieke Kaarten en Functionaliteiten
- Klok: Digitaal of analoog. De analoge klok heeft markeringen bij 12, 3, 6 en 9. Op een enkele tegel wordt een kalenderblok (weekdag, dag, maand) naast de wijzerplaat getoond; bij dubbele breedte wordt de digitale tijd met de datum ernaast getoond.
- Lichtbediening: Helderheid, regenboogkleuren en witte temperatuur, afhankelijk van de mogelijkheden van de lamp. Een lange aanraking opent de gedetailleerde bediening.
- Overige kaarten: Klimaat, stofzuiger, ventilator, raambekleding (cover), mediapeler, sensoren, select/inputselect, number/inputnumber, schakelaars, scènes, scripts en knoppen.
- Speciale kaarten (firmware 0.2.14+):
- Ingebouwde klok (digitaal of analoog).
- Weersvoorspelling voor vijf dagen op een kaart met dubbele breedte.
- Grafiek van de sensorhistorie in de tegel.
- Zonnepad (
sun.sun: horizon met de zon tussen zonsopgang en zonsondergang).
- Timer (
timer.*, tikken start of pauzeert de timer).
- Aanwezigheid (
person.*).
- Directe bediening op tegels met dubbele breedte (firmware 0.2.19+):
- Klimaat: Temperatuur − / + of modusknoppen.
- Schakelaars, lampen, ventilatoren: Toggle-knop.
- Stofzuiger: Start/stop/dock.
- Raambekleding: Open/stop/sluit of een positie-schuifregelaar.
- Media: Volume met mute of vorige/play/volgende.
- Getallen: − / + of een schuifregelaar.
- Select: Vorige/volgende.
- Timer: Start/pauze en annuleren.
- Scènes, scripts en knoppen: Een enkele knop.
Gedetailleerde Kaartfuncties
- Weerkaart: Toont actueel weer, de komende uren en dagen, inclusief regenkans of millimeters.
- Klimaatkaart: Bevat een aan/uit-knop, modus, ventilator en swing-instellingen. De doeltemperatuur staat centraal tussen − / + toetsen.
- Stofzuigerkaart: Toont status, batterij/opladen, start/dock en de reinigingsmodus (bijv. alleen stofzuigen, stofzuigen en dweilen, of alleen dweilen voor robots zoals Roborock).
- Scènes, scripts en knoppen: Toont wanneer ze voor het laatst zijn uitgevoerd. Tegels die wachten op Home Assistant tonen een kleine spinner.
- Raambekledingskaart (Cover): Voor blinds, gordijnen, rolluiken en garagedeuren. Bevat een verticale positie-schuifregelaar, een tilt-schuifregelaar voor lamellen, open/stop/sluit en de batterijstatus.
- Historiekaart: Voor sensoren, getallen, binaire sensoren, personen en schakelaars. Toont een lijn met as in ronde stappen en tijdstippen voor getallen, en een tijdlijn voor aan/uit status. Keuze tussen 1 uur, 24 uur of 1 week.
Interface-elementen
Bovenbalk (Top Bar)
Per scherm kan een bovenbalk worden geconfigureerd (firmware 0.2.32+). Links staat de naam, rechts kunnen tot zes items worden geplaatst:
- Tijd, analoge klok of datum.
- Entiteiten uit Home Assistant met een icoon (bijv. temperatuur, luchtvochtigheid, energieverbruik, status van een deur, alarm, wie er thuis is, of wanneer iets voor het laatst is gewijzigd).
Scherminstellingen
Instellingen kunnen worden gewijzigd in ESP Screens of direct op het scherm:
- Standby-tijd, normale en gedimde helderheid.
- Nachturen, 24- of 12-uurs klok.
- Terugkeer naar de startpagina en optioneel swipen tussen pagina's.
- Vanaf firmware 0.2.49+ zijn deze instellingen ook entiteiten in Home Assistant, waardoor ze via automatiseringen kunnen worden aangestuurd (bijv. Nachtmodus of Auto standby).
Instellingen op het scherm zelf
Vanaf firmware 0.2.44+ kun je de instellingenpagina openen door de bovenbalk ongeveer anderhalf seconde ingedrukt te houden. Hier kun je het volgende aanpassen:
- Helderheid, nachtmodus, klok, swipen en rotatie.
- Informatie over het scherm (naam, IP-adres, firmware, connectie met Home Assistant, en Herstart).
Automatiseringen en Meldingen
Alerts vanuit automatiseringen
Elk scherm heeft de actie esphome.<screen>showalert (firmware 0.2.31+). Dit plaatst een kaart over het hele scherm en wekt het scherm indien nodig.
Voorbeeld configuratie:
action: esphome.kitchen_screen_show_alert
data:
title: "Iemand staat voor de deur"
subtitle: "Deur 3, achterzijde"
icon: doorbell
color: orange
button_text: "Kom ik aan"
timeout: 0
flash: true
- Timeout: 0 betekent dat de kaart wacht tot er op de knop wordt gedrukt.
- Flash: Indien
true, knippert de backlight vier keer bij aankomst van de melding.
Meldingen op alle schermen
Vanaf app 0.2.45 kan één event een melding naar alle online schermen sturen via espscreensshow_alert.
AI-integratie met Claude
Je kunt Claude Code in Home Assistant gebruiken om een ESP Screens skill te installeren. Hiermee kan Claude direct wijzigingen aanbrengen via natuurlijke taal, zoals: "Zet de stofzuiger op het scherm in de woonkamer" of "Geef de lampen in de woonkamer een helderheid-schuifregelaar en maak die tegel breed".
Wake en Sleep via automatisering
Vanaf firmware 0.2.45 heeft elk scherm twee knoppen in Home Assistant:
button.<screen>_wake: Wekt het scherm uit standby of reset de standby-timer.button.<screen>_sleep: Zet het scherm direct in standby.
Installatie vanuit Home Assistant
Benodigde componenten
Je hoeft de aparte ESPHome Device Builder app niet te installeren, omdat de ESP Screen Manager de ESPHome CLI al bevat.
| Component | Nodig? | Doel |
|---|
| ESP Screen Manager app | Ja | Firmware installeren, tegels beheren en data versturen |
| ESPHome Device Builder app | Nee (optioneel) | Alternatieve editor en installer |
| ESPHome integratie in HA | Ja | De verbinding tussen Home Assistant en het fysieke scherm |
Stap-voor-stap installatie (HA OS)
- Voeg de repository toe aan de App store:
https://github.com/MaxGramser/homeassistant_espscreen
- Installeer ESP Screen Manager, start de app en open ESP Screens.
- Verbind het scherm via een USB-datakabel met de Home Assistant machine.
- Ga naar Settings → New screen, kies het model (CYD of Guition), geef het een naam, selecteer de USB-poort en klik op Install.
- Voer eventueel de Wi-Fi gegevens in als deze nog niet in
secrets.yaml staan.
- (Alleen voor CYD): Voer de kalibratie uit op het scherm.
- Koppel het ontdekte ESPHome-apparaat in Settings → Devices & services met de API-key die na installatie wordt getoond.
- Selecteer het scherm in ESP Screens, kies je tegels en klik op Save & send to screen.
Updates en Beheer
Update-overzicht
| Wijziging | Actie |
|---|
| Tegels, namen, kleuren of volgorde | Opslaan in ESP Screens (geen flash nodig) |
| Scherminstellingen | Wijzigen in ESP Screens, op het scherm, of via HA entiteiten |
| Nieuwe versie beheerpagina | Update ESP Screen Manager in de HA App store |
| Nieuwe feature op fysiek scherm | Update-knop op het scherm of automatische nachtelijke update |
Technische details en data-integriteit
- Data-behoud: Updates overschrijven geen gebruikersdata. CYD-kalibratie en schermvoorkeuren blijven op het apparaat bewaard.
- Efficiëntie: De app verstuurt alleen de tegel die is gewijzigd via
esphome.<devicename>screen_message in plaats van de volledige configuratie.
- Grafieken: Sensor-grafieken worden opgehaald uit de statistieken van Home Assistant in één query voor alle schermen.
Home Assistant ESP Screens
Ondersteunde schermen
| Scherm | Resolutie | Display / Touch |
|---|
| CYD ESP32-2432S028 | 320 × 240 | ILI9341 / resistief XPT2046 |
| Guition ESP32-S3-4848S040 (4 inch) | 480 × 480 | ST7701S RGB / capacitief GT911 |
Let op: Gebruik exact deze bordvarianten; vergelijkbare productnamen kunnen andere controllers of connectoren hebben. Wallbox-relais worden niet aangestuurd.
De firmware en de ingebouwde CLI zijn getest met ESPHome 2026.6.2.
Configuratiemogelijkheden
Tegels en Layout
Je kunt tot twintig tegels configureren, verdeeld over maximaal vier vaste pagina's van elk zes tegels. Je kunt zoeken op entiteit, apparaat of kamer en tegels verslepen om de volgorde te wijzigen.
Per tegel kun je het volgende instellen:
- Een aangepaste naam.
- Klikgedrag.
- Een kleine schuifregelaar (waar ondersteund).
- Een grote waarde voor zaken als temperatuur en energieverbruik.
- Vanaf firmware 0.2.13: De grote waarde toont een klein domein-icoon naast de titel. Te lange getallen worden afgebroken met een beletselteken (...), terwijl de eenheid zichtbaar blijft.
- Pastelkleurige achtergronden: Kies bijvoorbeeld rood voor een 'alles-uit' script, groen voor 'alles-aan', of een andere kleur. De titel en status blijven donker en leesbaar. De kleur is ook zichtbaar in de schermvoorvertoning. De optie 'Default' herstelt de normale kleuren. De optie 'None' verwijdert de kaart volledig, waardoor de inhoud direct op de achtergrond van het scherm staat (firmware 0.2.16).
Specifieke Kaarten en Functionaliteiten
- Klok: Digitaal of analoog. De analoge klok heeft markeringen bij 12, 3, 6 en 9. Op een enkele tegel wordt een kalenderblok (weekdag, dag, maand) naast de wijzerplaat getoond; bij dubbele breedte wordt de digitale tijd met de datum ernaast getoond.
- Lichtbediening: Helderheid, regenboogkleuren en witte temperatuur, afhankelijk van de mogelijkheden van de lamp. Een lange aanraking opent de gedetailleerde bediening.
- Overige kaarten: Klimaat, stofzuiger, ventilator, raambekleding (cover), mediapeler, sensoren, select/inputselect, number/inputnumber, schakelaars, scènes, scripts en knoppen.
- Speciale kaarten (firmware 0.2.14+):
- Ingebouwde klok (digitaal of analoog).
- Weersvoorspelling voor vijf dagen op een kaart met dubbele breedte.
- Grafiek van de sensorhistorie in de tegel.
- Zonnepad (
sun.sun: horizon met de zon tussen zonsopgang en zonsondergang).
- Timer (
timer.*, tikken start of pauzeert de timer).
- Aanwezigheid (
person.*).
- Directe bediening op tegels met dubbele breedte (firmware 0.2.19+):
- Klimaat: Temperatuur − / + of modusknoppen.
- Schakelaars, lampen, ventilatoren: Toggle-knop.
- Stofzuiger: Start/stop/dock.
- Raambekleding: Open/stop/sluit of een positie-schuifregelaar.
- Media: Volume met mute of vorige/play/volgende.
- Getallen: − / + of een schuifregelaar.
- Select: Vorige/volgende.
- Timer: Start/pauze en annuleren.
- Scènes, scripts en knoppen: Een enkele knop.
Gedetailleerde Kaartfuncties
- Weerkaart: Toont actueel weer, de komende uren en dagen, inclusief regenkans of millimeters.
- Klimaatkaart: Bevat een aan/uit-knop, modus, ventilator en swing-instellingen. De doeltemperatuur staat centraal tussen − / + toetsen.
- Stofzuigerkaart: Toont status, batterij/opladen, start/dock en de reinigingsmodus (bijv. alleen stofzuigen, stofzuigen en dweilen, of alleen dweilen voor robots zoals Roborock).
- Scènes, scripts en knoppen: Toont wanneer ze voor het laatst zijn uitgevoerd. Tegels die wachten op Home Assistant tonen een kleine spinner.
- Raambekledingskaart (Cover): Voor blinds, gordijnen, rolluiken en garagedeuren. Bevat een verticale positie-schuifregelaar, een tilt-schuifregelaar voor lamellen, open/stop/sluit en de batterijstatus.
- Historiekaart: Voor sensoren, getallen, binaire sensoren, personen en schakelaars. Toont een lijn met as in ronde stappen en tijdstippen voor getallen, en een tijdlijn voor aan/uit status. Keuze tussen 1 uur, 24 uur of 1 week.
Interface-elementen
Bovenbalk (Top Bar)
Per scherm kan een bovenbalk worden geconfigureerd (firmware 0.2.32+). Links staat de naam, rechts kunnen tot zes items worden geplaatst:
- Tijd, analoge klok of datum.
- Entiteiten uit Home Assistant met een icoon (bijv. temperatuur, luchtvochtigheid, energieverbruik, status van een deur, alarm, wie er thuis is, of wanneer iets voor het laatst is gewijzigd).
Scherminstellingen
Instellingen kunnen worden gewijzigd in ESP Screens of direct op het scherm:
- Standby-tijd, normale en gedimde helderheid.
- Nachturen, 24- of 12-uurs klok.
- Terugkeer naar de startpagina en optioneel swipen tussen pagina's.
- Vanaf firmware 0.2.49+ zijn deze instellingen ook entiteiten in Home Assistant, waardoor ze via automatiseringen kunnen worden aangestuurd (bijv. Nachtmodus of Auto standby).
Instellingen op het scherm zelf
Vanaf firmware 0.2.44+ kun je de instellingenpagina openen door de bovenbalk ongeveer anderhalf seconde ingedrukt te houden. Hier kun je het volgende aanpassen:
- Helderheid, nachtmodus, klok, swipen en rotatie.
- Informatie over het scherm (naam, IP-adres, firmware, connectie met Home Assistant, en Herstart).
Automatiseringen en Meldingen
Alerts vanuit automatiseringen
Elk scherm heeft de actie esphome.<screen>showalert (firmware 0.2.31+). Dit plaatst een kaart over het hele scherm en wekt het scherm indien nodig.
Voorbeeld configuratie:
action: esphome.kitchen_screen_show_alert
data:
title: "Iemand staat voor de deur"
subtitle: "Deur 3, achterzijde"
icon: doorbell
color: orange
button_text: "Kom ik aan"
timeout: 0
flash: true
- Timeout: 0 betekent dat de kaart wacht tot er op de knop wordt gedrukt.
- Flash: Indien
true, knippert de backlight vier keer bij aankomst van de melding.
Meldingen op alle schermen
Vanaf app 0.2.45 kan één event een melding naar alle online schermen sturen via espscreensshow_alert.
AI-integratie met Claude
Je kunt Claude Code in Home Assistant gebruiken om een ESP Screens skill te installeren. Hiermee kan Claude direct wijzigingen aanbrengen via natuurlijke taal, zoals: "Zet de stofzuiger op het scherm in de woonkamer" of "Geef de lampen in de woonkamer een helderheid-schuifregelaar en maak die tegel breed".
Wake en Sleep via automatisering
Vanaf firmware 0.2.45 heeft elk scherm twee knoppen in Home Assistant:
button.<screen>_wake: Wekt het scherm uit standby of reset de standby-timer.button.<screen>_sleep: Zet het scherm direct in standby.
Installatie vanuit Home Assistant
Benodigde componenten
Je hoeft de aparte ESPHome Device Builder app niet te installeren, omdat de ESP Screen Manager de ESPHome CLI al bevat.
| Component | Nodig? | Doel |
|---|
| ESP Screen Manager app | Ja | Firmware installeren, tegels beheren en data versturen |
| ESPHome Device Builder app | Nee (optioneel) | Alternatieve editor en installer |
| ESPHome integratie in HA | Ja | De verbinding tussen Home Assistant en het fysieke scherm |
Stap-voor-stap installatie (HA OS)
- Voeg de repository toe aan de App store:
https://github.com/MaxGramser/homeassistant_espscreen
- Installeer ESP Screen Manager, start de app en open ESP Screens.
- Verbind het scherm via een USB-datakabel met de Home Assistant machine.
- Ga naar Settings → New screen, kies het model (CYD of Guition), geef het een naam, selecteer de USB-poort en klik op Install.
- Voer eventueel de Wi-Fi gegevens in als deze nog niet in
secrets.yaml staan.
- (Alleen voor CYD): Voer de kalibratie uit op het scherm.
- Koppel het ontdekte ESPHome-apparaat in Settings → Devices & services met de API-key die na installatie wordt getoond.
- Selecteer het scherm in ESP Screens, kies je tegels en klik op Save & send to screen.
Updates en Beheer
Update-overzicht
| Wijziging | Actie |
|---|
| Tegels, namen, kleuren of volgorde | Opslaan in ESP Screens (geen flash nodig) |
| Scherminstellingen | Wijzigen in ESP Screens, op het scherm, of via HA entiteiten |
| Nieuwe versie beheerpagina | Update ESP Screen Manager in de HA App store |
| Nieuwe feature op fysiek scherm | Update-knop op het scherm of automatische nachtelijke update |
Technische details en data-integriteit
- Data-behoud: Updates overschrijven geen gebruikersdata. CYD-kalibratie en schermvoorkeuren blijven op het apparaat bewaard.
- Efficiëntie: De app verstuurt alleen de tegel die is gewijzigd via
esphome.<devicename>screen_message in plaats van de volledige configuratie.
- Grafieken: Sensor-grafieken worden opgehaald uit de statistieken van Home Assistant in één query voor alle schermen.
Groetjes,