Dispensa
Scansiona
Cosa vuoi fare?
Aggiungi alla Dispensa
Usa / Consuma
New Product
📦 Tutti i Prodotti
🍳 Ricette
🛒 Lista della Spesa
🧠 Previsioni intelligenti
0🤖 Identificazione AI
Scatta una foto del prodotto e l'AI cercherà di identificarlo
📋 Storico
⚙️ Configurazione
🧭 Configurazione guidata
…🌐 Lingua / Language
Seleziona la lingua dell'interfaccia. Select the interface language.
La pagina verrà ricaricata per applicare la nuova lingua.
💱 Valuta
La valuta usata per tutti i costi e i prezzi nell'app.
📍 Luoghi di conservazione
Aggiungi posti oltre a Dispensa, Frigo, Freezer e Altro (es. Cantina, Garage). I nomi restano così come li scrivi.
Predefiniti (non rimovibili): Dispensa, Frigo, Freezer, Altro.
🌙 Tema / Aspetto
Scegli il tema dell'interfaccia.
🌙 Salvaschermo
Mostra un orologio con fatti utili dopo un periodo di inattività. Di default è disattivato.
♻️ Suggerimenti zero-waste
Durante la cottura, mostra consigli su come riutilizzare gli scarti prodotti in ogni passo (bucce, acqua di cottura, ecc.). Disattivo per impostazione predefinita.
📤 Esporta inventario
Scarica l'inventario corrente in CSV o apri una versione stampabile (PDF).
📥 Importa inventario
Carica un CSV con lo stesso schema dell'export. Anteprima e conferma prima di scrivere.
🏷️ Nomi e preferiti automatici
Ogni articolo porta davanti al titolo il suo genere (es. «Yogurt Fiori di latte»). Se il nome non lo dice, l'app lo ricava dal dizionario interno e — solo se serve — chiede all'AI una parola sola, poi la tiene in cache per i prodotti simili.
utilizzi — solo i 3 più usati in assoluto (0 = disattivato)
🤖 Intelligenza artificiale
Scegli un solo provider. Se l’AI è disattivata, nessun servizio che la usa funziona.
🤖 Google Gemini
Chiave API per identificazione prodotti, scadenze e ricette.
🔌 Test connessione
Invia una richiesta minima al provider selezionato e misura il tempo di risposta.
🛒 Lista della spesa
EverShelf ha la propria lista della spesa. Bring! è opzionale e fa solo da mirror.
Assistenza AI
rimasto in magazzino (0 = solo quando esaurito)
🛒 Dopo un acquisto
Quando scannerizzi un prodotto in modalità Spesa, quando toglierlo dalla lista?
In lista Spesa, «Spesa fatta» svuota tutta la lista e blocca i ri-aggiunti automatici fino al prossimo esaurimento.
💰 Stima prezzi
Mostra un costo stimato sulla lista della spesa. Puoi usare l’AI, i prezzi aperti di Open Food Facts (gratis), o entrambi.
Motore ricette, Mealie e collegamento con la lista spesa.
🧠 Motore ricette
Scegli da dove EverShelf prende le ricette quando premi «Genera ricetta».
🍽️ Mealie — collegamento
Mealie è un ricettario self-hosted. EverShelf cerca tra le tue ricette (anche offline dopo la sync).
⚙️ Opzioni avanzate Mealie
🛒 Ricette e lista spesa
Quando una ricetta (Mealie o Gemini) richiede ingredienti che non hai in dispensa.
👨🍳 Preferenze ricette
Opzioni predefinite per la generazione delle ricette.
🌤 Meteo per «A ritmo mio»
Opzionale e disattivo di default. Se attivo, le ricette «A ritmo mio» tengono conto del meteo nella zona scelta (es. caldo → piatti freschi). Dati da Open-Meteo, senza API key.
Dati meteo: Open-Meteo.com (CC BY 4.0)
🫀 Dati personali e biologici
Profilo biologico e sync attività (telefono). Se disattivi la funzione, tutto resta grigio e le ricette «A ritmo mio» non usano i dati salute.
Se attivo, la generazione ricette propone già il chip Fuel Mode.
Profilo biologico
Health Bridge (telefono)
Installa l’app Android sul telefono (stessa Wi‑Fi). Legge Health Connect / Google Fit e sincronizza le calorie con EverShelf.
📥 Scarica Health Bridge (APK)1) Scarica e installa l’APK sul telefono. 2) Crea il token qui. 3) Nell’app scansiona il QR: passa URL del server + token insieme. Nessuna digitatura.
📅 Piano Pasti Settimanale
Imposta la tipologia di pasto per ogni giorno. Sarà usata come guida nella generazione delle ricette.
📋 Tipologie disponibili
🔌 Elettrodomestici Disponibili
Indica gli elettrodomestici che hai a disposizione. Saranno considerati nella generazione delle ricette.
Aggiungi velocemente:
📷 Fotocamera
Scegli quale fotocamera utilizzare per la scansione barcode e l'identificazione AI.
Se hai più fotocamere, puoi selezionarne una specifica dall'elenco sopra dopo aver concesso i permessi.
Se il barcode non si legge, usa il pulsante «Identifica con AI» sotto la fotocamera. Richiede Gemini configurato.
🔗 Codice di associazione
Mostra questo codice su un nuovo telefono, tablet o kiosk quando chiede di associarsi. Valido 30 minuti; si rinnova automaticamente.
Caricamento codice…
🔑 Token Impostazioni
Se SETTINGS_TOKEN è configurato nel .env server, inserisci qui il token prima di salvare le impostazioni. Lascia vuoto se non configurato.
🔒 Certificato HTTPS
Se il browser mostra l'errore "La connessione non è privata" (ERR_CERT_AUTHORITY_INVALID), devi installare il certificato CA nel dispositivo.
1. Scarica il certificato qui sopra
2. Vai in Impostazioni → Sicurezza e privacy → Altre impostazioni di sicurezza → Installa da archivio dispositivo
3. Seleziona il file EverShelf_CA.crt scaricato
4. Scegli "CA" e conferma
5. Riavvia Chrome
Istruzioni per Chrome (PC):
1. Scarica il certificato qui sopra
2. Vai in chrome://settings/certificates (o Impostazioni → Privacy e sicurezza → Sicurezza → Gestisci certificati)
3. Tab "Autorità" → Importa → seleziona il file
4. Spunta "Considera attendibile per identificare siti web"
5. Riavvia Chrome
🔊 Voce & TTS
Configura la sintesi vocale. Puoi usare la voce offline del browser oppure un endpoint REST esterno (Home Assistant, ecc.).
Le voci disponibili dipendono dal sistema operativo e dal browser. Su macOS/iOS è disponibile la voce Paola (italiano). Premi ↺ se la lista non si carica.
🏠 Home Assistant
Integra EverShelf con Home Assistant: TTS su speaker smart, webhook per automazioni, sensori per la dashboard.
URL base della tua istanza HA (senza slash finale). Es: http://homeassistant.local:8123
Genera un token in HA → Profilo → Token di accesso a lungo termine.
🔊 TTS su Speaker Smart
Leggi i passi della ricetta su un altoparlante gestito da HA (Sonos, Echo, Google Home, ecc.).
Copia l'entity ID del media player da HA → Strumenti sviluppatore → Stati.
Configura automaticamente il tab TTS con i parametri HA corretti.
⚡ Automazioni Webhook
EverShelf chiama il webhook HA quando si verificano eventi (prodotto in scadenza, aggiunto alla lista, ecc.).
Crea un'automazione in HA con trigger "Webhook" e copia qui l'ID. Come farlo?
Quanti giorni prima della scadenza inviare l'alert.
📱 Notifiche Push
EverShelf invia notifiche push tramite il servizio notify.* di HA (Telegram, Pushover, app mobile, ecc.).
Formato: notify.NOME_SERVIZIO. Lascia vuoto per disabilitare. Richiede token HA configurato.
📊 Sensori REST per HA
HA può leggere i dati dell'inventario via REST polling. Aggiungi questo snippet a configuration.yaml:
🔔 Notifiche push
Ricevi gli avvisi su scadenze e lista della spesa senza Home Assistant: basta un topic ntfy o un webhook.
Interruttore principale per i canali ntfy e webhook. Il servizio notify di Home Assistant continua a funzionare separatamente.
Scegli cosa deve arrivarti sul telefono. Le scadenze sono consigliate: gli altri eventi possono essere frequenti.
Lingua del testo generato dal server (l'interfaccia segue la lingua del browser).
ntfy è gratuito e non richiede account: scegli un topic segreto e iscriviti con l'app ntfy (Android, iOS o web).
Lascia https://ntfy.sh oppure inserisci il tuo server ntfy self-hosted (es. http://192.168.1.50:8080).
Solo lettere, numeri, trattino e underscore (max 64). Chi conosce il topic può leggerlo e pubblicare: trattalo come una password.
Serve solo se il tuo server ntfy richiede autenticazione (Authorization: Bearer).
Separati da virgola, es. ever-shelf,warning. Aggiungono un'icona accanto alla notifica.
Un POST JSON verso qualsiasi URL: n8n, Node-RED, Gotify, un bridge Discord o Slack…
Nome dell'header che porta il token (default: Authorization: Bearer …).
Attiva solo per un server ntfy o webhook nella tua LAN con certificato self-signed.
⏱️ Cron watchdog (dead-man's switch)
Optional. Every scheduled job pings this URL when it finishes, so a missing ping is what raises the alarm. Works with Healthchecks.io (hc-ping.com/<uuid>) and with a self-hosted Uptime Kuma push URL (…/api/push/<token>). The URL is a secret: it is not shown again after saving, and anyone who knows it can silence the alarm.
✈️ Bot Telegram
Per chi non installa la PWA: /lista e /scadenze nel bot. Opzionale e gratuito.
Da @BotFather. Lascia vuoto per non modificare un token già salvato.
Separati da virgola. Vuoto = accetta qualsiasi chat (sconsigliato).
setWebhook su api.telegram.org con questo URL (HTTPS pubblico).
📱 Notifiche nel browser (PWA)
Gratis, senza ntfy: il browser riceve gli stessi avvisi quando la PWA è installata su HTTPS. Opzionale.
🏠 Il servizio notify di Home Assistant resta attivo: se l'hai configurato, gli stessi eventi arrivano anche lì.
🗓️ Calendario scadenze
Iscriviti alle scadenze della dispensa dal tuo calendario: ogni prodotto diventa un evento di tutta la giornata, con promemoria il giorno prima.
Quante scadenze future finiscono nel calendario (1–365).
Le scadenze appena passate restano nel calendario con il prefisso ⚠️ (0–60).
🔗 Link da iscrivere
Il feed è disattivato: attiva l'interruttore e salva per generare il link.
Il link contiene una chiave di sola lettura: chi lo possiede vede le tue scadenze. Rigeneralo per revocare tutte le vecchie iscrizioni.
⚖️ Bilancia Smart
Collega una bilancia Bluetooth tramite il gateway Android per leggere il peso automaticamente.
📱 EverShelf Scale Gateway
App Android che fa da ponte tra la bilancia BLE e questo sito.
📥 Scarica Gateway Android (APK)Sorgente: evershelf-scale-gateway/ nella root del progetto
Copia l'URL mostrato dall'app Android (stessa rete Wi-Fi). Es: ws://192.168.1.100:8765
🔌 Protocolli BLE supportati:
- Bluetooth SIG Weight Scale (0x181D)
- Bluetooth SIG Body Composition (0x181B) — peso, grasso, BMI
- Xiaomi Mi Body Composition Scale 2
- Generico — heuristica automatica su 100+ modelli
💾 Backup Locale
Snapshot giornaliero automatico del database. Massimo 3 giorni di storico (configurabile).
Caricamento…
☁️ Google Drive
Carica automaticamente il backup su Google Drive usando un Service Account.
Copia l'ID dalla URL della cartella Drive: …/folders/ID
📋 Come configurare OAuth 2.0 (passo dopo passo)
http://localhost
Registra questo URI in Google Cloud Console come "URI di reindirizzamento autorizzato". Per le installazioni senza dominio pubblico usa http://localhost.
Gemini AI — Token Usage
Utilizzo AI, inventario e sistema
Caricamento…
Inventario
Caricamento…
Attività del mese
Caricamento…
Sistema
Caricamento…
🔗 Codice di associazione
Per associare un altro dispositivo usa questo codice (anche in Impostazioni → Sistema → Sicurezza).
Caricamento codice…
EverShelf Kiosk
Trasforma un tablet Android in un pannello EverShelf sempre acceso, con bilancia BLE integrata.
—
Scarica l’APK sul telefono/tablet e aprilo per installare. Preferisci il server locale in LAN; GitHub se sei fuori rete.