Home Assistant
Come configurare Kiosk Mode in Home Assistant
Guida tecnica avanzata per configurare Kiosk Mode in Home Assistant tramite HACS, rimuovere elementi superflui e ottimizzare i tablet a parete.
Introduzione alla Kiosk Mode in Home Assistant
La configurazione della modalità Kiosk su Home Assistant rappresenta il passaggio fondamentale per trasformare un comune tablet Android o iPad in un pannello di controllo domotico dedicato, stabile e privo di distrazioni. Rimuovendo elementi nativi dell'interfaccia come la barra laterale, l'intestazione superiore e i pulsanti di configurazione, si ottiene un'esperienza utente pulita, simile a quella di un sistema di supervisione professionale. Questa guida approfondisce l'installazione e la personalizzazione avanzata utilizzando strumenti open source e pacchetti community, garantendo al contempo un metodo di ripristino sicuro per evitare il blocco accidentale dell'amministratore.
Prima di iniziare, è importante verificare i prerequisiti di sistema. Questa configurazione richiede un'istanza di Home Assistant correttamente avviata su hardware compatibile, come ad esempio un Home Assistant Green o un Home Assistant Yellow, con l'architettura aggiornata all'ultima versione stabile del Core e del Frontend. È indispensabile disporre di permessi di amministratore e aver già installato HACS (Home Assistant Community Store) per il recupero dei componenti non ufficiali. Tra i limiti da considerare vi è la forte dipendenza dalle modifiche del DOM (Document Object Model) introdotte nei rilasci mensili di Home Assistant: un aggiornamento del frontend potrebbe temporaneamente alterare il comportamento della mod, richiedendo verifiche e piccoli adeguamenti del codice YAML.
Prerequisiti, Strumenti e Installazione via HACS
L'ecosistema di Home Assistant si basa su aggiornamenti frequenti che possono modificare la gestione delle risorse web. Per implementare la Kiosk Mode in modo pulito, la soluzione più affidabile consiste nell'utilizzare la risorsa personalizzata kiosk-mode disponibile tramite HACS. Questa risorsa agisce direttamente sul rendering della pagina web caricata dal browser del tablet, nascondendo selettivamente i componenti in base alle preferenze dell'utente o ai parametri passati nell'URL.
Verifica della presenza di HACS
Accedi al pannello di controllo del tuo Home Assistant e verifica la presenza della voce HACS nel menu laterale. Se non è installata, procedi alla configurazione seguendo la documentazione ufficiale della community. Una volta attivo HACS, entra nella sezione Frontend, cerca il repository denominato Kiosk Mode e procedi al download dell'ultima versione stabile. Questa azione scaricherà il file JavaScript necessario e lo registrerà automaticamente tra le risorse della dashboard.
Configurazione delle risorse e pulizia della cache
Dopo aver completato il download tramite HACS, assicurati che la risorsa sia correttamente censita in Impostazioni > Dashboard > Risorse. Spesso il browser del tablet o l'applicazione companion memorizzano nella cache le vecchie risorse visive. Si consiglia vivamente di effettuare un hard reset della cache del browser del dispositivo client o di riavviare l'applicazione mobile di Home Assistant per evitare conflitti di visualizzazione durante le fasi successive di personalizzazione.
Configurazione delle Dashboard e dei Profili Utente
Una volta integrata la risorsa, la Kiosk Mode può essere applicata globalmente o configurata specificamente per determinati utenti e dispositivi. La gestione dei profili utente è cruciale: non vuoi che il pannello di amministrazione principale perda i menu di configurazione, mentre desideri che il tablet dedicato al muro mostri esclusivamente la vista meteo e i controlli delle luci senza alcuna barra di navigazione.
Parametri di configurazione YAML
La configurazione si effettua modificando il file di configurazione della dashboard in modalità YAML oppure agendo sulle opzioni avanzate dell'interfaccia grafica. I parametri principali includono l'istruzione per nascondere la barra laterale (hide_sidebar), l'intestazione (hide_header) e le opzioni di modifica (hide_toolbar). Puoi impostare regole condizionali basate sul nome utente loggato, garantendo che solo l'utente associato al tablet subisca le restrizioni visive.
kiosk_mode: non_admin_settings: hide_sidebar: true hide_header: true hide_toolbar: true users: - username: tablet_parete hide_sidebar: true hide_header: trueIn questo frammento di esempio, l'utente tablet_parete vedrà la sua interfaccia completamente depurata da qualsiasi elemento di navigazione, massimizzando lo spazio disponibile sullo schermo del dispositivo.
Procedura passo dopo passo per l'attivazione
- Apri il pannello di controllo di Home Assistant e assicurati di disporre dei privilegi di utente amministratore.
- Avvia HACS dal menu laterale e clicca sulla sezione Frontend per gestire i componenti grafici aggiuntivi.
- Cerca il pacchetto Kiosk Mode utilizzando la barra di ricerca interna di HACS e seleziona la versione più recente.
- Clicca sul pulsante di download e conferma l'installazione, attendendo il completamento del processo di scrittura del file.
- Verifica in Impostazioni, Dashboard e Risorse che il percorso del file JavaScript sia correttamente registrato dal sistema.
- Accedi alla vista della dashboard che desideri trasformare in modalità schermo intero e apri il menu di modifica in alto a destra.
- Seleziona la voce per modificare la configurazione in formato YAML e inserisci le direttive specifiche per nascondere intestazione e barra laterale.
- Salva le modifiche apportate alla dashboard e ricarica completamente la pagina del browser per applicare le nuove regole visive.
- Disconnettiti dall'account amministratore ed effettua l'accesso con l'account utente destinato al display fisso.
- Verifica che gli elementi di navigazione siano scomparsi e che il layout si adatti correttamente alle proporzioni dello schermo del tablet.
Verifica del Risultato e Ripristino Sicuro
La verifica della corretta installazione richiede attenzione, poiché una configurazione errata potrebbe precludere l'accesso ai menu di configurazione dell'utente amministratore. Per testare il sistema senza rischi, accedi sempre utilizzando una scheda in modalità incognito del browser o un secondo dispositivo di supporto. Se la Kiosk Mode è configurata correttamente, l'utente associato al tablet visualizzerà una schermata pulita, mentre l'amministratore manterrà il controllo completo di tutte le funzioni di sistema.
Come ripristinare l'interfaccia in caso di blocco
Se, a causa di un errore di sintassi nel codice YAML o di una regola troppo restrittiva, non dovessi più visualizzare i menu per correggere la configurazione, esiste un metodo sicuro per ripristinare l'accesso. È sufficiente aggiungere il parametro di query ?disable_km=true alla fine dell'indirizzo URL della tua dashboard (ad esempio: http://homeassistant.local:8123/lovelace/0?disable_km=true). Questo comando di emergenza disattiva temporaneamente la Kiosk Mode sul client corrente, permettendoti di accedere nuovamente alle impostazioni e correggere il file di configurazione.
Problemi Comuni e Risoluzione
| Problema riscontrato | Causa principale | Soluzione corretta |
|---|---|---|
| La barra laterale non scompare sull'utente specifico | Nome utente errato o risorsa non caricata correttamente | Verificare il nome esatto dell'utente nel pannello persone e pulire la cache del browser. |
| L'URL di emergenza non disattiva la modalità | Censimento delle risorse HACS non aggiornato o app mobile nativa | Utilizzare un browser web standard per forzare il parametro di bypass o riavviare l'app companion. |
| Il layout si deforma dopo un aggiornamento del Core | Incompatibilità temporanea del componente frontend con la nuova versione | Aggiornare Kiosk Mode all'ultima versione disponibile tramite HACS o verificare le note di rilascio. |
Domande Frequenti (FAQ)
La Kiosk Mode blocca completamente l'accesso alle impostazioni?
No, se configurata correttamente applicando le restrizioni solo agli utenti secondari o ai profili dedicati ai display a parete, l'amministratore manterrà pieno accesso a tutte le funzioni di configurazione e manutenzione del sistema.
Cosa fare se l'applicazione mobile del tablet non recepisce le modifiche?
Le applicazioni companion per Android e iOS mantengono spesso in memoria una cache persistente dei file grafici. È consigliabile svuotare la cache dell'applicazione dalle impostazioni di sistema del tablet o effettuare una disconnessione e un nuovo accesso.
È possibile utilizzare Kiosk Mode senza installare HACS?
Sebbene sia teoricamente possibile scaricare manualmente il file JavaScript e caricarlo nella cartella www di Home Assistant, l'utilizzo di HACS è fortemente consigliato per la gestione semplificata degli aggiornamenti e la corretta registrazione automatica delle risorse.
La modalità schermo intero influisce sulle automazioni o sulle prestazioni del sistema?
Nessun impatto sulle prestazioni o sulle automazioni di background. Kiosk Mode è una modifica puramente estetica e lato client che agisce esclusivamente sul rendering visivo della dashboard nel browser del dispositivo.
Prodotti consigliati
Hardware pertinente alla guida
I collegamenti portano alle pagine dei prodotti indicati. Il prezzo Amazon, quando disponibile, proviene dall’API ufficiale ed è aggiornato con data e ora; prezzo e disponibilità finali sono quelli della pagina Amazon.