Mealie Smart-Home-Integration, kostenlos und Open Source
Essensplan und Einkaufslisten von Mealie in Gladys: Menüs, Szenen, Widgets.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Mealie ist eine selbst gehostete Rezeptverwaltung: deine Rezepte, ein Essensplan für die Woche und gemeinsame Einkaufslisten. Diese Integration bringt Mealie in Gladys: Ein Gerät zeigt die Mahlzeiten von heute und morgen, die Zahl der Rezepte und die noch zu kaufenden Einträge jeder Liste; Szenen können einen Eintrag auf eine Liste setzen („die Milch ist alle“), einen abhaken, ein Rezept planen oder das Menü des Tages senden; zwei Dashboard-Widgets zeigen das Menü und eine Einkaufsliste, mit Schaltflächen zum Hinzufügen, Abhaken und Planen direkt am Wand-Tablet.
Getestet mit echten Mealie-Servern 2.0.0 und 3.28; noch nicht auf einer echten Gladys-Installation: Rückmeldungen sind willkommen in den Issues.
Was du brauchst
- Gladys Assistant 5.2.0 oder neuer.
- Mealie 2.0 oder neuer (Mealie 1.x hat keine Haushalts-API), erreichbar vom Gladys-Rechner aus: im lokalen Netz oder im Internet per HTTPS.
- Ein API-Token eines Mealie-Benutzers. Es handelt mit den Rechten dieses Benutzers, auf dem Essensplan und den Einkaufslisten seines Haushalts.
Erste Schritte
1. Ein API-Token erstellen
Klicke in Mealie auf deinen Avatar, öffne dein Profil und dann
API-Token. Gib dem Token einen Namen (zum Beispiel Gladys) und klicke auf
Erzeugen. Kopiere das Token: Mealie zeigt es nur einmal.
2. Die Integration konfigurieren
In Gladys unter Integrationen → Mealie → Konfiguration:
- Adresse von Mealie: die Adresse, mit der du Mealie öffnest, mit Port,
zum Beispiel
http://192.168.1.2:9925oderhttps://mealie.example.com. Eine aus dem Browser kopierte Adresse (…/g/home/recipes) geht auch. - API-Token: das Token aus Schritt 1.
- Selbstsignierte Zertifikate akzeptieren: nur für eine
https://-Adresse, deren Zertifikat auch dein Browser nicht anerkennt. - Aktualisierungsintervall: wie oft Mealie gelesen wird, standardmäßig 5 Minuten (1 bis 15 Minuten). Was du in Gladys tust, erscheint sofort.
- Sprache der Namen und Meldungen: die Sprache der Funktionsnamen und der Texte der Szenen-Aktionen (standardmäßig Französisch).
Speichere und klicke dann auf Verbindung testen: Mealie antwortet mit seiner Version, seinem Haushalt und dem, was es enthält.
3. Das Gerät anlegen
Lege unter Integrationen → Mealie → Entdecken das Gerät Mealie an. Seine Werte erscheinen sofort. Wird in Mealie eine Einkaufsliste erstellt, bietet das Gerät im Tab „Entdecken“ Aktualisieren an: Dann kommt ihr Zähler hinzu.
Das Gerät Mealie
Ein Gerät pro Mealie-Haushalt (der Haushalt des Token-Benutzers). Seine Funktionen:
| Funktion | Typ | Wert |
|---|---|---|
Frühstück heute | Text | Die Rezepte (oder Notizen) des Essensplans, oder „Nichts geplant“ |
Mittagessen heute | Text | Ebenso |
Abendessen heute | Text | Ebenso |
Frühstück morgen | Text | Ebenso, für morgen |
Mittagessen morgen | Text | Ebenso |
Abendessen morgen | Text | Ebenso |
Rezepte | Zähler | Zahl der Rezepte in Mealie |
Zu kaufen: <Liste> | Zähler | Noch zu kaufende Einträge jeder Einkaufsliste (nicht abgehakt) |
Zwei Rezepte für eine Mahlzeit erscheinen als Quiche lorraine · Salat.
„Heute“ folgt der Zeitzone von Gladys: Kurz nach Mitternacht werden die
Mahlzeiten von morgen zu denen von heute. Die Namen werden beim Anlegen des
Geräts in der Sprache der Konfiguration vergeben und bleiben danach so (eine
Regel von Gladys).
Dashboard-Widgets
Füge unter Dashboard → Dashboard bearbeiten ein Widget der Integration Mealie hinzu.
Speiseplan
- Zeitraum: Heute: das Datum und eine Zeile pro Mahlzeit des Tages (Frühstück, Mittagessen, Abendessen, Beilage, Zwischenmahlzeit, Getränk, Nachspeise).
- Zeitraum: Nächste 7 Tage: eine Zeile pro Tag, heute und morgen markiert; tippe auf einen Tag, um seine Mahlzeiten zu sehen.
- Planen öffnet ein kurzes Formular (Rezept, Tag, Mahlzeit) und setzt das Rezept in den Essensplan von Mealie. Ein leeres Rezept lässt Mealie zufällig eins wählen (seine Essensplan-Regeln gelten). Dasselbe Rezept, das für dieselbe Mahlzeit schon geplant ist, wird nicht doppelt hinzugefügt.
- Aktualisieren liest Mealie neu.
- Mealie öffnen öffnet den Essensplaner, wenn Mealie eine
https://-Adresse hat (Gladys öffnet keine anderen Links).
Einkaufsliste
Die noch zu kaufenden Einträge einer Liste (Einstellung Einkaufsliste: ihr Name in Mealie; leer: die zuerst erstellte Liste), mit Menge und Notiz.
- Hinzufügen öffnet ein Formular mit einem Feld, Eintrag: so eingegeben, wie er auf der Liste stehen soll. Ein Eintrag, der schon auf der Liste steht (Groß- und Kleinschreibung, Akzente und Plural egal), wird nicht doppelt hinzugefügt.
- Abhaken öffnet ein Formular mit den Einträgen: Der gewählte wird in Mealie abgehakt, wie in der App (dort abwählen macht es rückgängig).
- Aktualisieren liest Mealie neu.
- Mealie öffnen öffnet die Liste, wenn Mealie eine
https://-Adresse hat.
Szenen
Aktionen
| Aktion | Felder | Ergebnisse |
|---|---|---|
| Zur Einkaufsliste hinzufügen | Eintrag, Einkaufsliste (leer: die erste) | Eintrag hinzugefügt (ja/nein), Eintrag, Liste, Einträge zu kaufen |
| Eintrag der Einkaufsliste abhaken | Eintrag, Einkaufsliste | Eintrag abgehakt (ja/nein), Eintrag, Liste, Einträge zu kaufen |
| Rezept zum Essensplan hinzufügen | Rezept (leer: zufällig), Tag, Mahlzeit | Rezept hinzugefügt (ja/nein), Rezept, Datum |
| Mahlzeiten eines Tages lesen | Tag (heute, morgen, übermorgen) | Frühstück, Mittagessen, Abendessen, alle Mahlzeiten des Tages, geplante Mahlzeiten |
| Einkaufsliste lesen | Einkaufsliste | Einträge zu kaufen (durch Kommas getrennt), Anzahl, Liste |
- Ein Eintrag wird so gefunden, wie du ihn nennst:
oeufsfindetŒufs,TomatenfindetTomate. Eine Liste wird über ihren Namen gefunden oder über seinen Anfang (einkfürEinkäufe). - Ein Rezept wird über seinen Namen oder einen Teil davon gefunden, wie in der Suche von Mealie.
- Ein Eintrag, der schon auf der Liste steht, wird nicht noch einmal hinzugefügt: Das Ergebnis Eintrag hinzugefügt ist dann „nein“. Ein Eintrag, der nicht auf der Liste steht, ist kein Fehler: Eintrag abgehakt ist „nein“.
- Die Ergebnisse gehen an die folgenden Aktionen der Szene, zum Beispiel eine
Nachricht
Heute Abend: {{0.0.dinner}}(0.0: die Position der Aktion in der Szene; der Nachrichteneditor listet die Ergebnisse auf). - Die Mahlzeiten Zwischenmahlzeit, Getränk und Nachspeise brauchen Mealie 3.7 oder neuer; ein älteres Mealie kennt Frühstück, Mittagessen, Abendessen und Beilage.
Auslöser
Keine. Was sich in Mealie ändert (eine geplante Mahlzeit, eine längere Liste),
ist ein Zustand des Geräts: Eine Szene startet bei einer Änderung von
Zu kaufen: Einkäufe oder von Abendessen heute mit dem üblichen Auslöser
„Gerätezustand“.
Szenen-Ideen
- „Die Milch ist alle“: Ein Knopf (oder ein Sprachassistent) startet Zur
Einkaufsliste hinzufügen mit
Milch. - Das Menü am Morgen: jeden Tag um 7:30 Mahlzeiten eines Tages lesen
(heute), dann
Mittag: {{0.0.lunch}}, Abend: {{0.0.dinner}}per Telegram senden. - Auf dem Weg zum Einkaufen: Wenn jemand die Arbeit verlässt, Einkaufsliste lesen und die Einträge senden, falls es welche gibt.
- Noch kein Abendessen geplant: um 17:00, wenn
Abendessen heute„Nichts geplant“ ist, Rezept zum Essensplan hinzufügen ohne Rezept (Mealie wählt eins) und es ansagen.
Aktualisierung und Nutzung der Mealie-API
Die Integration liest Mealie mit ihrem eigenen Timer (Gladys fragt es nicht ab), im Intervall der Konfiguration und kurz nach Mitternacht. Ein Lesevorgang sind vier Anfragen: der Essensplan der nächsten sieben Tage, die Einkaufslisten, die zu kaufenden Einträge aller Listen (eine Anfrage), die Statistik; „wer bin ich“ (Version und Haushalt) wird einmal pro Stunde neu gelesen. Mealie setzt kein API-Kontingent. Eine Szenen-Aktion oder ein Widget liest Mealie neu, wenn der letzte Lesevorgang älter als 30 Sekunden ist; was die Integration ändert, wird sofort neu gelesen.
Nur die Werte, die sich ändern, gehen an Gladys, und alle Werte noch einmal alle 6 Stunden.
Fehlerbehebung
- „API-Token abgelehnt“: Das Token wurde gelöscht oder gehört zu einem anderen Mealie. Erstelle ein neues (Schritt 1).
- „Mealie antwortet nicht“: Prüfe Adresse und Port vom Gladys-Rechner aus
(
http://<Adresse>:9925/api/app/aboutmuss antworten). Das Symbol des Geräts zeigt dann „nicht erreichbar“, und seine Werte bleiben die zuletzt gelesenen. - „Zertifikat abgelehnt“: Aktiviere Selbstsignierte Zertifikate
akzeptieren oder nutze im lokalen Netz die
http://-Adresse. - „Mealie 2.0 oder neuer ist nötig“: Aktualisiere Mealie.
- „kein Mealie unter dieser Adresse“: Die Adresse antwortet mit einer anderen Webseite (Anmeldeseite eines Reverse-Proxys…). Nutze die Adresse von Mealie selbst.
- Eine Liste hat keinen Zähler: Öffne den Tab „Entdecken“ und klicke beim Gerät Mealie auf Aktualisieren.
- Mehr Details: Setze die Umgebungsvariable
LOG_LEVELaufdebug; die Protokolle enthalten nie das API-Token.
Grenzen
- Ein Mealie-Haushalt pro Integration: der Haushalt des Token-Benutzers.
- Das Gerät zeigt Frühstück, Mittagessen und Abendessen von heute und morgen; die anderen Mahlzeiten (Beilage, Zwischenmahlzeit, Getränk, Nachspeise) und der Rest der Woche stehen im Widget und in Mahlzeiten eines Tages lesen.
- Einträge werden als freier Text hinzugefügt (Mealie liest ihre Menge nicht aus) und nie gelöscht: Abgehakte Einträge bleiben in Mealie, bis du sie dort entfernst.
- Das Formular Abhaken listet die ersten 50 Einträge; das Widget zeigt 7 Einträge und die Zahl der übrigen.
- Mealie öffnen erscheint nur bei einer
https://-Adresse. - Noch nicht auf einer echten Gladys-Installation getestet; getestet mit echten Mealie-Servern 2.0.0 und 3.28.
Konfigurationseinstellungen
Diese Einstellungen fragt Mealie in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Mealie | section | Nein | Öffne in Mealie dein Profil, dann API-Token, erzeuge ein Token und füge es unten mit der Adresse von Mealie ein. Lege dann das Gerät Mealie im Tab „Entdecken“ an. |
| Adresse von Mealie | string | Ja | Die Adresse, mit der du Mealie öffnest, mit Port (mit Docker standardmäßig 9925). |
| API-Token | secret | Ja | Erstellt in Mealie: Profil → API-Token → Erzeugen. Es handelt mit den Rechten deines Benutzers. |
| Selbstsignierte Zertifikate akzeptieren | boolean | Nein | Nur für eine https://-Adresse, deren Zertifikat auch dein Browser nicht anerkennt. |
| Aktualisierungsintervall | select | Nein | Wie oft Mealie gelesen wird. Änderungen aus Gladys erscheinen sofort. |
| Sprache der Namen und Meldungen | select | Nein | Namen der Funktionen (beim Anlegen des Geräts festgelegt) und Texte der Szenen-Aktionen. |
So installierst du Mealie in Gladys
- Öffne in Gladys Integrationen: Mealie erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-mealie:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-mealie.
Mealie benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Mealie ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation