EverShelfv2.1.1

Lista

Scansiona

Cosa vuoi fare?

Aggiungi alla Dispensa

pz

Usa / Consuma

Quanto hai usato?

—

New Product

L'AI compilerà automaticamente i campi del prodotto

Separa i tag con una virgola.

Il prodotto generico a cui appartiene questa variante (Barilla → Spaghetti). Vuoto = prodotto a sé.

📦 Tutti i Prodotti

🍳 Ricette

🛒 Lista della Spesa

Connessione a Bring!...

🧠 Previsioni intelligenti

0

🤖 Identificazione AI

Scatta una foto del prodotto e l'AI cercherà di identificarlo

📋 Storico

📊 Statistiche

⚙️ Configurazione

Accesso e stato

Le informazioni che servono subito: come è protetto questo server, come associare un altro dispositivo, quando è stato fatto l'ultimo backup e quale versione stai usando.

Token di accesso —

—

Codice di associazione

Caricamento codice…

Ultimo backup —

—

Versione

—

🧭 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.

🌙 Tema / Aspetto

Scegli il tema dell'interfaccia.

🌙 Salvaschermo

Mostra un orologio con fatti utili dopo un periodo di inattività. Di default è disattivato.

Viste della lavagna

Ogni vista legge i tuoi dati: il pasto con una ricetta vera, le scadenze, i grafici della dispensa e un'idea presa dal magazzino.

Lo mostra subito per 30 secondi, senza cambiare l'impostazione: un tocco lo chiude. Con un indirizzo puoi forzarlo per il tempo che vuoi: ?screensaver=90.

📍 Luoghi di conservazione

Aggiungi posti oltre a Dispensa, Frigo e Freezer (es. Cantina, Garage). I nomi restano così come li scrivi.

Ogni luogo si può eliminare, anche i predefiniti: basta che sia vuoto.

📤 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.

🗄️ Conservazione dei dati

Quanto a lungo l'app tiene ciò che produce da sola. Numeri più bassi = archivio più leggero, stime meno precise.

I piani pasto creati dall'AI vengono cancellati dopo questi giorni (1–365).

giorni

La lista della spesa impara le frequenze da qui: sotto i 30 giorni le stime diventano inaffidabili.

giorni

Giorni in più che una confezione sottovuoto guadagna rispetto alla scadenza della sua categoria (0 = nessun prolungamento).

giorni

🏷️ 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.

Etichette libere («senza glutine», «bio», «bimbi») sulle card e per filtrare la dispensa.

Un prodotto generico (Spaghetti) con le sue varianti (Barilla, Rummo): la dispensa mostra la variante, il totale della famiglia in una riga.

Inventario veloce

Un prodotto alla volta, tre risposte grandi: la dispensa si sistema in un paio di minuti, senza scanner. Si avvia dalla lista della stanza che stai controllando.

Salva ogni

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)

♻️ 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.

💊 Farmaci e armadietto

Modulo opzionale: separa i farmaci dal cibo e risponde a «cosa ho in casa per…» con i tuoi prodotti, non con consigli. Disattivo finché non lo accendi.

Nessun catalogo di farmaci viene interrogato: il codice a barre (anche l'etichetta SSN) resta agganciato alla scatola che crei tu, e il nome lo scrivi tu. Funziona in ogni paese, senza API.

EverShelf è un inventario domestico: non fornisce diagnosi, non sostituisce il medico e non indica dosi.

🫀 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.

🌤️ = Pranzo  ·  🌙 = Cena  ·  Tocca un badge per cambiarlo.

📋 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.

📥 Scarica Certificato CA

Le istruzioni passo passo per Android e PC si aprono in una finestra: non occupano la pagina.

🔊 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.

🏠 Se usi Home Assistant, usa il tab Home Assistant per configurare TTS, webhook e sensori.

🏠 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

🔌 Supported BLE protocols:

  • Bluetooth SIG Weight Scale (0x181D)
  • Bluetooth SIG Body Composition (0x181B) — weight, fat, BMI
  • Xiaomi Mi Body Composition Scale 2
  • Generic — automatic heuristic on 100+ models

💾 Local Backup

One backup per day while the cron runs (the Docker image runs it automatically). Files live in data/backups — copy them off the data volume for real safety.

Loading…

Loading…

☁️ Google Drive

Upload the daily backup to Google Drive automatically (OAuth 2.0, no external library).

Copy the ID from the Drive folder URL: …/folders/ID

📋 How to set up OAuth 2.0 (step by step)
    Redirect URI (add it in Google Cloud Console): http://localhost

    Register this URI in Google Cloud Console as an “Authorized redirect URI”. Installations without a public domain use 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 APK da questo server 🐙 Scarica da GitHub (kiosk-latest)

    Scarica l’APK sul telefono/tablet e aprilo per installare. Preferisci il server locale in LAN; GitHub se sei fuori rete.

    About

    Version —

    Qualcosa non funziona? Inviaci una segnalazione direttamente dall'app.

    🔌 API gratuite

    EverShelf le usa quando servono; senza, l'app funziona lo stesso. Nessuna chiave a pagamento, nessun tracciamento.

    Grazie a queste API gratuite

    Grazie agli autori e ai volontari che mantengono questi progetti.

    ❤️ Sostieni EverShelf

    Il progetto è gratuito e senza pubblicità: qui decidi se fare una donazione una volta, o niente per ora.

    💚 Grazie a chi rende possibile tutto questo

    EverShelf sta in piedi su servizi gratuiti e aperti: nessuna chiave a pagamento, nessun tracciamento. Ecco chi sono, dove li usiamo e con quale licenza.

    Le foto e i dati dei prodotti arrivano dalla comunità di Open Food Facts, i prezzi da Open Prices, meteo e geocoding da Open-Meteo. Senza di loro l'app funziona lo stesso, ma sarebbe molto più povera.

    I loghi appartengono ai rispettivi progetti e sono usati solo per identificarli.

    Salvataggio automatico: le modifiche si salvano da sole