KitchenOwl Smart-Home-Integration, kostenlos und Open Source
KitchenOwl-Einkaufslisten und Essensplan: zu kaufende Artikel, heutige Mahlzeiten, Artikelpflege.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.2.0
- ★ 0
Hol die Einkaufslisten und den Essensplan deines KitchenOwl in Gladys: wie viele Artikel noch zu kaufen sind, was heute und morgen gekocht wird. Füge einen Artikel über das Dashboard oder eine Szene hinzu („die Milch ist alle“), hake einen mit einem Tippen ab und lass eine Szene reagieren, wenn jemand etwas auf die Liste setzt.
Feedback willkommen. Diese Integration wurde mit einem echten KitchenOwl-Server getestet (Docker-Image
tombursch/kitchenowl, Oktober 2026), aber noch nicht im Alltag mit einem echten Gladys. Wenn etwas nicht wie beschrieben funktioniert, sag es bitte im Gladys-Forum oder in den Issues.
Was du brauchst
- Gladys Assistant 5.2.0 oder neuer (die Formulare der Widget-Tasten).
- Ein selbst gehostetes KitchenOwl, von Gladys aus erreichbar (das Docker-Image lauscht auf Port 8080).
- Ein langlebiges Token eines KitchenOwl-Benutzers. In KitchenOwl: dein
Profil → Sitzungen → Langlebige Token → eines hinzufügen,
Gladysnennen und das Token kopieren: KitchenOwl zeigt es nur einmal an.
Die Integration sieht die Haushalte dieses Benutzers und fügt Artikel in
seinem Namen hinzu oder hakt sie ab. Der gehostete Dienst
app.kitchenowl.org bietet dieselbe API, wurde aber nicht getestet.
Einrichtung
- In Gladys Integrationen → KitchenOwl installieren.
- In der Konfiguration die Adresse von KitchenOwl
(
http://192.168.1.20:8080,https://owl.example.org…; die aus dem Browser kopierte Adresse funktioniert auch) und das langlebige Token eingeben. - Optionen:
- Selbstsignierte Zertifikate akzeptieren: nur für eine
https://-Adresse mit selbstsigniertem Zertifikat, auf deinem eigenen Server. - Aktualisierungsintervall: wie oft KitchenOwl gelesen wird, 30 Sekunden bis 5 Minuten (standardmäßig 1 Minute). Mitternacht wird immer pünktlich berücksichtigt.
- Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen eines Geräts und die an Szenen gesendeten Texte (standardmäßig Französisch).
- Selbstsignierte Zertifikate akzeptieren: nur für eine
- Speichern, dann auf Verbindung testen klicken: Es meldet die Haushalte, die Listen und die Zahl der zu kaufenden Artikel.
- Den Tab Entdecken öffnen und die gewünschten Geräte hinzufügen.
Geräte
Ein Gerät pro Einkaufsliste (KitchenOwl Default, KitchenOwl Bricolage…), mit einer Funktion:
| Funktion | Wert |
|---|---|
| Zu kaufende Artikel | die Zahl der Artikel auf der Liste. |
Ein Gerät pro Haushalt (KitchenOwl <Haushalt>), für den Essensplan:
| Funktion | Wert |
|---|---|
| Heutige Mahlzeiten | die heute geplanten Rezepte, durch Kommas getrennt, oder Nichts geplant |
| Morgige Mahlzeiten | dasselbe für morgen |
„Heute“ ist der Tag in der Zeitzone von Gladys. Rezepte ohne Tag („irgendwann“) werden nicht angezeigt. Bei mehreren Haushalten tragen die Listengeräte auch den Namen des Haushalts.
Die Werte werden nur bei Änderungen gesendet (und sonst alle 12 Stunden). Das Geräte-Badge zeigt Nicht erreichbar, wenn KitchenOwl nicht antwortet.
Dashboard
Das Widget Einkaufsliste zeigt eine Liste: die Zahl der Artikel, die Artikel mit ihrer Beschreibung (neun, dann eine Zeile „Weitere Artikel“) und vier Tasten:
- Hinzufügen öffnet ein Formular (Artikel, Beschreibung): Der Artikel kommt auf die Liste, nie doppelt.
- Abhaken öffnet ein Formular mit den Artikeln: Der gewählte wird abgehakt.
- Die ersten beiden Artikel haben eine eigene Taste, um sie mit einem Tippen abzuhaken.
Wähle in den Widget-Einstellungen ein Listengerät oder ein Haushaltsgerät für dessen Standardliste. Leer: die Standardliste des ersten Haushalts. Das Widget funktioniert schon, bevor ein Gerät zu Gladys hinzugefügt wurde.
Szenen
Auslöser
Artikel zu einer KitchenOwl-Liste hinzugefügt: Ein Artikel wurde auf eine Einkaufsliste gesetzt, in KitchenOwl oder über Gladys. Artikel, die beim Start der Integration schon auf den Listen stehen, zählen nicht, und die Integration merkt sich über Neustarts hinweg, was sie gesehen hat (ein Artikel, der hinzugefügt wurde, während sie gestoppt war, löst beim nächsten Start aus). Ein abgehakter und wieder hinzugefügter Artikel zählt erneut. Höchstens zwanzig Ereignisse pro Liste und Lesevorgang (ein Rezept, das dreißig Zutaten hinzufügt).
- Filter: Einkaufsliste (ein Listengerät; ein Haushaltsgerät passt nie; leer: beliebig), Name des Artikels (genauer Name, leer: beliebig).
- Variablen:
item(Artikel),description,list_name(Liste),added_by(der KitchenOwl-Name des Mitglieds) undfrom_gladys(wahr, wenn der Artikel von einer Szene oder dem Widget hinzugefügt wurde: So kann eine Szene ihre eigenen Einträge ignorieren).
Aktionen
Zu einer KitchenOwl-Liste hinzufügen: setzt einen Artikel auf eine Liste.
Felder: Artikel (Pflicht), Beschreibung (eine Menge, optional),
Einkaufsliste (ein Listengerät oder ein Haushaltsgerät für dessen
Standardliste; leer: die Standardliste des ersten Haushalts). Ein Artikel,
der schon auf der Liste steht (Groß- und Kleinschreibung und Akzente egal),
wird nicht doppelt hinzugefügt: Seine Beschreibung wird durch die neue
ersetzt, falls angegeben. Ausgaben: item, list_name, already_on_list.
KitchenOwl-Artikel abhaken: hakt einen Artikel auf einer Liste ab, nach
Namen (Groß- und Kleinschreibung und Akzente egal). Nicht auf der Liste:
Nichts passiert, und die Ausgabe removed ist falsch. Ausgaben: item,
list_name, removed.
Die Felder akzeptieren Szenenvariablen ({{triggerEvent.data.item}}…).
Szenenideen
- Eine Taste an der Kaffeemaschine → Zu einer KitchenOwl-Liste
hinzufügen, Artikel
Kaffee: Die letzte Kapsel wird nie wieder vergessen. - Artikel zu einer KitchenOwl-Liste hinzugefügt, Liste
Baumarkt→ eine Nachricht an den, der zum Baumarkt fährt: „{{triggerEvent.data.item}} hinzugefügt von {{triggerEvent.data.added_by}}“. - Jeden Tag um 17 Uhr → Heutige Mahlzeiten des Haushaltsgeräts lesen und senden: Das Abendessen ist vor Feierabend bekannt.
- Zu kaufende Artikel über 15 → eine Erinnerung, dass es Zeit zum Einkaufen ist.
Fehlerbehebung
- „Token abgelehnt“: Das langlebige Token wurde widerrufen oder falsch abgeschrieben. Erstelle in KitchenOwl ein neues und füge es erneut ein (ein mitkopiertes „Bearer “ wird entfernt).
- „keine KitchenOwl-API unter dieser Adresse“: Etwas antwortet, aber nicht KitchenOwl. Prüfe den Port (8080 beim Docker-Image) und hinter einem Reverse-Proxy das Pfadpräfix.
- „KitchenOwl antwortet nicht“: falsche Adresse, KitchenOwl gestoppt oder eine Firewall zwischen Gladys und KitchenOwl.
- „Zertifikat abgelehnt“: Aktiviere Selbstsignierte Zertifikate akzeptieren.
- „Der Benutzer des Tokens gehört zu keinem KitchenOwl-Haushalt“: Erstelle einen Haushalt in KitchenOwl oder nutze das Token eines Mitglieds.
- Eine neue Liste erscheint nicht: Klicke im Tab Entdecken auf Suchen oder warte auf den nächsten Lesevorgang.
- Details stehen in den Protokollen der Integration (
LOG_LEVEL=debugfür jeden Lesevorgang).
Grenzen
- Die Integration liest KitchenOwl in festen Abständen (30 s bis 5 min): Ein in KitchenOwl hinzugefügter Artikel erreicht Gladys innerhalb dieser Zeit. Den Echtzeitkanal von KitchenOwl nutzt sie nicht.
- Der Essensplan wird gelesen, nicht bearbeitet; Ausgaben und Rezepte werden nicht genutzt.
- Die Auswahl in einem Widget-Formular bietet die ersten 50 Artikel an.
- Die Funktionsnamen werden beim Hinzufügen eines Geräts vergeben: Eine spätere Sprachänderung benennt sie nicht um.
- Mit einem echten KitchenOwl-Server in Docker getestet, noch nicht mit einem echten Gladys: Feedback willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt KitchenOwl in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein KitchenOwl | section | Nein | Ein selbst gehostetes KitchenOwl. Erstelle in KitchenOwl ein langlebiges Token: Profil, Sitzungen, Langlebige Token. Artikel werden im Namen des Token-Benutzers hinzugefügt. |
| Adresse | string | Ja | Adresse von KitchenOwl, mit https:// für HTTPS und :Port, falls nicht Standard (8080 beim Docker-Image). |
| Langlebiges Token | secret | Ja | Erstellt in KitchenOwl: Profil, Sitzungen, Langlebige Token. Wird nur einmal angezeigt. |
| Optionen | section | Nein | |
| Selbstsignierte Zertifikate akzeptieren | boolean | Nein | Für eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren. |
| Aktualisierungsintervall | select | Nein | Wie oft KitchenOwl gelesen wird. Mitternacht wird immer pünktlich berücksichtigt. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen beim Hinzufügen eines Geräts und an Szenen gesendete Texte. |
So installierst du KitchenOwl in Gladys
- Öffne in Gladys Integrationen: KitchenOwl erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-kitchenowl:1.0.0) 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-kitchenowl.
KitchenOwl 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
KitchenOwl 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