Smart Home Pantry: la dispensa intelligente per Home Assistant

Il problema: buttiamo via cibo senza accorgercene

Apri la dispensa, sposti due scatole e la trovi lì in fondo: la passata di pomodoro scaduta tre mesi fa. Oppure lo yogurt dimenticato dietro il latte.
Succede a tutti.

Non è una questione di disorganizzazione: è che non abbiamo un sistema.
Ci ricordiamo di quello che vediamo, e quello che finisce in fondo a un ripiano semplicemente sparisce dai radar finché non è troppo tardi.

Le app per la spesa esistono, certo. Ma sono l'ennesima app da aprire, l'ennesimo account da creare, l'ennesimo posto dove i tuoi dati finiscono chissà dove.
E soprattutto: sono staccate da tutto il resto.

E se invece la dispensa vivesse dentro Home Assistant, insieme a tutto il resto della casa?

Da questa domanda è nata Smart Home Pantry.

Cos'è Smart Home Pantry

Smart Home Pantry è un'integrazione personalizzata per Home Assistant che trasforma il tuo sistema domotico in un gestore completo della dispensa di casa.

In pratica: inquadri il codice a barre con il telefono, il prodotto viene riconosciuto e aggiunto, tu inserisci la data di scadenza, e da quel momento il sistema tiene tutto sotto controllo. Quando qualcosa sta per scadere, te lo dice.

Tutto questo senza account da creare, senza abbonamenti, senza chiavi API da configurare. I dati restano a casa tua, dentro la tua installazione di Home Assistant.

È gratuita, open source (licenza MIT) e installabile tramite HACS.

Come funziona: scansiona e via

Il cuore dell'integrazione è la scansione del codice a barre.

Apri la card sul telefono, tocca Aggiungi, si apre la fotocamera. Inquadri il codice EAN sulla confezione e in un attimo il nome del prodotto compare già compilato: "Latte parzialmente scremato Granarolo". Ti resta solo da indicare quantità e scadenza.

I dati dei prodotti arrivano da Open Food Facts, un enorme database alimentare collaborativo e gratuito, costruito da volontari di tutto il mondo. Contiene milioni di prodotti, inclusi moltissimi italiani.

E se il prodotto non c'è? ✍️

Capita, soprattutto con prodotti locali o marchi del discount. In quel caso l'integrazione non ti lascia a piedi: ti presenta il campo del nome vuoto e lo scrivi tu.
Il prodotto viene salvato comunque nella tua dispensa, associato a quel codice a barre. La volta dopo che lo riscansioni, se lo ricorda.

Cache intelligente

Ogni ricerca viene messa in cache per 30 giorni. Questo significa che riscansionare un prodotto già visto è immediato e non interroga di nuovo il server: più veloce per te, meno traffico per Open Food Facts.

La gestione a lotti: il dettaglio che fa la differenza

Qui c'è la funzione di cui vado più fiero, perché risolve un problema che le soluzioni banali ignorano.

Immagina di avere tre confezioni di latte: una scade domani, una fra una settimana, una fra un mese. Un sistema semplice ti direbbe "hai 3 latti". Ma è un'informazione inutile: quello che conta è che una scade domani.

Smart Home Pantry gestisce i lotti separati: stesso prodotto, scadenze diverse, tenute distinte. Nella card vedi il prodotto raggruppato, e sotto ogni singola scadenza con il suo indicatore colorato.

Logica FEFO

Quando prelevi un pezzo dalla dispensa, quale viene tolto? Quello che scade prima. È la logica FEFO (First Expired, First Out), la stessa che usano i magazzini alimentari professionali.

Tu tocchi semplicemente "Preleva", e il sistema fa la cosa giusta senza che tu debba pensarci.

Le notifiche: sapere prima che sia tardi

Una volta al giorno, all'orario che scegli tu, l'integrazione passa in rassegna la dispensa e ti avvisa se qualcosa sta per scadere.

Puoi ricevere:

• Una notifica persistente dentro Home Assistant
• Una notifica push sull'app Companion del telefono

Un solo controllo al giorno, così non vieni tempestato di avvisi. E l'orario lo decidi tu: alle 9 del mattino se vuoi saperlo appena sveglio, alle 19 se preferisci scoprirlo prima di fare la spesa.

Doppia soglia: arancione e rosso

Non tutte le scadenze hanno la stessa urgenza, quindi ho previsto due livelli:

• Giorni di preavviso (predefinito: 7) — da qui il prodotto diventa arancione: "occhio, scade tra poco"
• Giorni critici (predefinito: 2) — da qui diventa rosso con il punto esclamativo: "usalo subito!"

Entrambi i valori sono personalizzabili. Chi fa la spesa una volta a settimana vorrà un preavviso più lungo, chi la fa ogni due giorni può stringere.

La card grafica: bella e già pronta

Molte integrazioni ti lasciano con dei sensori grezzi e l'onere di costruirti la dashboard. Qui no: la card Lovelace è inclusa e si registra da sola.

Niente file da copiare nella cartella www, niente risorse da aggiungere a mano nel menù delle configurazioni. Installi, riavvii, e aggiungi la card. Fine.

La card mostra:

• Tre contatori in evidenza: prodotti totali, in scadenza, scaduti
• La prossima scadenza in arrivo
• I prodotti raggruppati con l'emoji della categoria, riconosciuta automaticamente dal nome
• Barre colorate che indicano a colpo d'occhio lo stato di ogni lotto
• I pulsanti per aggiungere, prelevare, rimuovere, aggiornare

Per usarla basta aggiungere una card manuale con:

type: custom:smart-home-pantry-card

Pannello nella barra laterale

Se preferisci, puoi attivare un'opzione che aggiunge la dispensa direttamente nel menù laterale di Home Assistant, a tutta pagina. Un clic e sei dentro, senza doverla infilare in una dashboard.

Il nome della voce lo scegli tu: "Dispensa", "Cucina", quello che vuoi.

I prodotti scaduti: contali, azzerali, esportali

Quando qualcosa scade, l'integrazione non lo cancella: lo tiene da parte.

Nella card compare una riga rossa con il conteggio dei prodotti scaduti, e due pulsanti:

• Azzera — rimuove tutti i prodotti scaduti in un colpo solo, lasciando intatti quelli ancora buoni
• Excel — scarica la lista completa in un file .xlsx

Il file Excel contiene nome, codice a barre, quantità, data di scadenza e giorni trascorsi, ordinati dal più vecchio.

Perché esportare gli scaduti?

Può sembrare una funzione bizzarra, ma è sorprendentemente utile: ti fa capire cosa butti via più spesso. Se dopo tre mesi scopri che hai buttato sei confezioni di yogurt, forse ne compri troppo. È il primo passo per ridurre gli sprechi davvero.

E una nota tecnica di cui sono contento: il generatore di file Excel l'ho scritto da zero, senza librerie esterne. Questo significa che l'integrazione non installa nessuna dipendenza aggiuntiva sul tuo sistema — meno cose che possono rompersi.

Personalizzazione: tutto dall'interfaccia

Nessun file YAML da modificare a mano. Tutte le impostazioni si trovano cliccando sull'ingranaggio dell'integrazione:

Opzione	A cosa serve
Notifica persistente	Avviso dentro Home Assistant
Notifica push	Avviso sull'app Companion
Orario controllo	Quando controllare le scadenze
Giorni di preavviso	Soglia "in scadenza"
Giorni critici	Soglia "urgente"
Barra laterale	Mostra la dispensa nel menù
Formato data	gg/mm/aaaa, aaaa-mm-gg, relativo...
Prossima scadenza entro	Quando mostrare la riga in cima
Scaduti entro	Per quanto contare gli scaduti
Ordinamento	Scadenza, alfabetico, quantità

Il formato data merita una nota: oltre ai formati classici c'è la modalità relativa, che invece di "22/07/2026" scrive "Tra 3 giorni". Molto più immediato da leggere al volo.

L'ordinamento offre cinque criteri, incluso "in esaurimento prima", che mette in cima i prodotti di cui ti restano meno pezzi: comodissimo per capire cosa ricomprare.

Configurazione per singola card

Le impostazioni dell'integrazione valgono come predefinite, ma ogni card può sovrascriverle:

type: custom:smart-home-pantry-card
days_before: 5
date_format: relative
sort_order: alphabetical

Così puoi avere una card compatta in salotto e una completa in cucina, con comportamenti diversi.

Per chi ama le automazioni

Sotto la superficie, l'integrazione crea nove sensori che puoi usare liberamente nelle tue automazioni:

• sensor.smart_home_pantry — il totale dei pezzi, con l'elenco completo negli attributi
• sensor.expiring_products — quanti prodotti stanno per scadere
• sensor.expired_products — quanti sono già scaduti
• sensor.next_expiry — la prossima data di scadenza
• sensor.unique_products — quanti prodotti diversi hai
• ...e altri per l'ultimo prodotto scansionato

E dieci servizi richiamabili da automazioni e script: aggiungere prodotti, prelevare pezzi, modificare lotti, azzerare gli scaduti, esportare in Excel.

Qualche idea di automazione?

• Un annuncio vocale quando aggiungi un prodotto
• Un promemoria sul telefono il sabato mattina prima della spesa
• L'invio automatico via email del report Excel degli scaduti a fine mese
• Una luce che diventa rossa se ci sono prodotti scaduti

Come si installa

L'integrazione si installa tramite HACS come repository personalizzato:

1. Apri HACS in Home Assistant
2. Clicca sui tre puntini in alto a destra
3. Seleziona Repository personalizzati
4. Incolla l'indirizzo: https://github.com/DomoticaFacile/smart_home_pantry
5. Categoria: Integrazione → Aggiungi
6. Cerca Smart Home Pantry nell'elenco e installala
7. Riavvia Home Assistant

Poi vai su Impostazioni → Dispositivi e servizi → Aggiungi integrazione, cerca Smart Home Pantry e completa il setup. Tutto qui.

Un progetto aperto, che cresce

Smart Home Pantry è open source con licenza MIT.

Hai un'idea? Hai trovato un comportamento strano? Vorresti una funzione che non c'è? Apri una issue su GitHub o scrivici sui canali di Domotica Facile.
Ogni segnalazione è preziosa e molte delle funzioni attuali sono nate da suggerimenti.

E se il progetto ti piace, lascia una stella al repository: ci aiuta concretamente a farlo entrare nello store ufficiale di HACS e a farlo scoprire ad altre persone.

Link utili

• Repository GitHub: https://github.com/DomoticaFacile/smart_home_pantry
• Segnalazioni e suggerimenti: https://github.com/DomoticaFacile/smart_home_pantry/issues
• Donazione DomoticaFacile.it: https://www.buymeacoffee.com/domoticafacile
• Open Food Facts: https://world.openfoodfacts.org
• Open Food Facts Donazione: https://world.openfoodfacts.org/donate-to-open-food-facts

Buona dispensa a tutti!