Zum Hauptinhalt springen

Planka Smart-Home-Integration, kostenlos und Open Source

Planka-Integration für Gladys Assistant

Planka-Kanban-Boards: heute fällige und überfällige Karten, Verschiebungen, Karten aus Szenen.

Auf GitHub ansehenAlle Integrationen

Hol die Kanban-Boards deines Planka in Gladys: die heute fälligen Karten, die überfälligen, die nächste Fälligkeit und die Anzahl der Karten in jeder Liste eines Boards. Eine Szene reagiert, wenn eine Karte in einer Liste ankommt (Erledigt, Zu prüfen…) oder fällig wird, eine andere fügt „Brot kaufen“ per Taste hinzu oder verschiebt eine Karte per NFC-Tag, ein Tippen auf dem Dashboard hakt eine Fälligkeit ab, und Gladys kann jeden Morgen die Karten des Tages vorlesen.

Feedback willkommen. Diese Integration wurde gegen einen echten Planka-Server getestet (Docker-Image ghcr.io/plankanban/planka 2.2.1, Oktober 2026), noch nicht im Alltag. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.1.0 oder neuer.
  • Ein selbst gehostetes Planka 2 (getestet mit 2.2.1), von Gladys aus erreichbar. Planka 1.x wird nicht unterstützt: Seine API ist anders.
  • Eines von beiden, für einen Planka-Benutzer, der Mitglied der zu verfolgenden Boards ist:
    • ein API-Schlüssel (empfohlen): Ein Administrator erstellt ihn in Planka, Administration → Benutzer → Menü des Benutzers → API-Schlüssel → API-Schlüssel erstellen. Kopiere ihn: Planka zeigt ihn nur einmal. Er funktioniert auch mit Zwei-Faktor-Anmeldung und Single Sign-on;
    • oder Benutzername (oder E-Mail) und Passwort des Benutzers. Er muss sich einmal in der Weboberfläche angemeldet haben, um die Bedingungen zu akzeptieren, die Planka bei der ersten Anmeldung verlangt, und darf keine Zwei-Faktor-Anmeldung nutzen.

Die Integration sieht die Boards, die dieser Benutzer sieht, und handelt in seinem Namen. Ein Benutzer, der ein Board nur betrachten darf, kann es verfolgen, aber keine Karten hinzufügen oder verschieben.

Einrichtung​

  1. In Gladys Integrationen → Planka installieren.
  2. Im Bildschirm Konfiguration ausfüllen:
    • Adresse: die Adresse von Planka wie im Browser, zum Beispiel http://192.168.1.20:3000, oder https://kanban.example.org hinter einem Reverse-Proxy (ein Pfadpräfix wie /planka bleibt erhalten);
    • API-Schlüssel, oder Benutzername oder E-Mail und Passwort. Ist der API-Schlüssel ausgefüllt, wird er verwendet.
  3. Optionen:
    • Verfolgte Boards: Namen durch Kommas getrennt (Haushalt, Einkauf), oder die ID eines Boards (die Zahl in seiner Adresse). Leer: alle Boards des Benutzers, höchstens 20;
    • Selbstsignierte Zertifikate akzeptieren: für eine https://-Adresse mit selbstsigniertem Zertifikat, nur auf deinem eigenen Server;
    • Aktualisierungsintervall: 1 bis 10 Minuten (standardmäßig 5). Fälligkeiten und Mitternacht werden immer pünktlich verfolgt, egal bei welchem Intervall;
    • Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen eines Geräts (standardmäßig Französisch) und die an Szenen gesendeten Texte.
  4. Speichern, dann Verbindung testen: Das liest Planka und nennt die Anzahl der offenen Karten und der verfolgten Boards.
  5. Im Tab Erkennung die gewünschten Geräte hinzufügen.

Geräte​

Planka Board für jedes verfolgte Board, mit diesen Funktionen:

FunktionWas sie angibt
Offene Kartendie Karten der aktiven Listen (nicht die einer geschlossenen Liste wie Erledigt, nicht archiviert)
Heute fällige Kartenoffene Karten, deren Fälligkeit heute ist, vorbei oder nicht, ohne abgehakte Fälligkeit
Überfällige Kartenoffene Karten, deren Fälligkeit vorbei ist, ohne abgehakte Fälligkeit
eine pro Listedie Anzahl der Karten jeder der ersten fünf aktiven Listen, nach der Liste benannt
Nächste Fälligkeitdie Karte mit der nächsten kommenden Fälligkeit und ihr Datum; Keine, wenn es keine gibt

„Heute“ ist der Tag in der Zeitzone von Gladys. Eine Karte mit abgehakter Fälligkeit oder in einer geschlossenen Liste (die „Erledigt“-Art von Liste in Planka) ist nicht mehr fällig. Die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt: Eine später umbenannte Liste behält in Gladys ihren alten Namen. Eine neue Liste unter den ersten fünf lässt Gladys im Tab Erkennung ein Update des Geräts anbieten.

Dashboard​

Das Widget Heutige Karten zeigt zwei Kacheln (heute fällig, überfällig), die Liste der bis heute Abend fälligen Karten, Überfälliges zuerst, mit Uhrzeit, Liste und Board, und eine Schaltfläche für jede der vier dringendsten: Ein Tippen hakt die Fälligkeit der Karte in Planka ab. Wähle in den Widget-Einstellungen ein Board-Gerät, um nur seine Karten zu sehen; lass es leer für alle verfolgten Boards. Wenn nichts fällig ist, sagt das Widget es und nennt die nächste Fälligkeit.

Die Zähler können auch wie jede Gerätefunktion aufs Dashboard.

Szenen​

Auslöser​

  • Planka-Karte verschoben: Eine Karte ist in einer anderen Liste ihres Boards angekommen. Filter: das Board (ein Board-Gerät), der Listenname, genau wie in Planka (Erledigt). An die Aktionen übergebene Informationen: die Karte, ihre ID, ihr Board, ihre Liste, die vorherige Liste, ihre Fälligkeit.
  • Planka-Karte fällig: Eine offene Karte hat ihre Fälligkeit erreicht, ohne abgehakt zu sein.
  • Planka-Karte überfällig: Um Mitternacht ist eine an diesem Tag fällige Karte noch nicht erledigt. Einmal pro Karte und Fälligkeit.

Filter der letzten beiden: das Board, der Kartenname. An die Aktionen übergebene Informationen: die Karte, ihre ID, ihr Board, ihre Liste, ihre Fälligkeit.

Eine Verschiebung wird beim nächsten Lesen erkannt: innerhalb des Aktualisierungsintervalls. Eine neu erstellte oder aus einem anderen Board geholte Karte ist keine Verschiebung. Eine vor ihrer Fälligkeit erledigte Karte löst nichts aus, ebenso wenig eine von Hand vor das vorherige Lesen verschobene Fälligkeit. Ein Neustart löst nichts doppelt aus; eine Verschiebung, während die Integration gestoppt war, löst beim Neustart aus, ebenso eine Fälligkeit, die weniger als eine Stunde zurückliegt.

Aktionen​

  • Planka-Karte hinzufügen: ein Titel; das Board nach Namen (leer: das erste verfolgte Board); die Liste nach Namen (leer: seine erste aktive Liste); eine optionale Fälligkeit, in der Uhrzeit von Gladys: 2026-10-24 18:00, 2026-10-24 (Mittag), oder ab jetzt +30m, +2h, +3d. Die Karte kommt ans Ende der Liste. Ergebnisse: die Karte, ihre ID, ihr Board, ihre Liste, ihre Fälligkeit.
  • Planka-Karte verschieben: die Karte nach ihrem genauen Namen (Groß-/Kleinschreibung und Akzente egal) oder ihrer ID, die Zielliste nach Namen, und das Board, wenn zwei Boards eine Karte dieses Namens haben. Die Karte kommt ans Ende der Liste; eine Karte einer geschlossenen Liste kann zurückkommen. Ergebnisse: die Karte, ihre ID, ihr Board, ihre Liste, die vorherige Liste.
  • Heutige Planka-Karten vorlesen: die bis heute Abend fälligen Karten als Satz (3 Karte(n) bis heute Abend fällig: …. 2 überfällig.), für alle verfolgten Boards oder eines davon. Ergebnisse: der Satz, die Anzahl der bis heute Abend fälligen und der überfälligen Karten. Schick den Satz in einer Nachricht, oder lass ihn Gladys sagen.

Die Felder akzeptieren Szenenvariablen: {{triggerEvent.data.card}} verschiebt die Karte, die die Szene ausgelöst hat.

Szenenideen​

  • Um 7:30 Heutige Planka-Karten vorlesen, dann den Satz per Telegram senden.
  • Planka-Karte verschoben in die Liste Erledigt des Boards Haushalt: der Familie „gut gemacht“ schicken oder die Erinnerungslampe ausschalten.
  • Wenn die Waschmaschine fertig ist, Planka-Karte hinzufügen Wäsche aufhängen in Zu tun, fällig +1h.
  • Ein NFC-Tag an den Mülltonnen startet Planka-Karte verschieben Müll rausbringen nach Erledigt.

Fehlerbehebung​

  • „Planka antwortet nicht“: Prüfe Adresse und Port vom Gladys-Rechner aus (die Adresse öffnet Planka im Browser).
  • „API-Schlüssel, Benutzername oder Passwort abgelehnt“: Der Schlüssel wurde neu erzeugt oder gelöscht, oder das Passwort hat sich geändert. Erstelle einen neuen Schlüssel.
  • „Melde dich einmal in der Planka-Weboberfläche an, um die Bedingungen zu akzeptieren“: Melde dich einmal mit diesem Benutzer im Browser an, akzeptiere die Bedingungen, dann erneut Verbindung testen.
  • „Zwei-Faktor-Anmeldung: Verwende stattdessen einen API-Schlüssel“: Ein Benutzer mit Zwei-Faktor-Anmeldung kann sich von Gladys aus nicht mit Passwort anmelden.
  • „Keine Planka-2-API unter dieser Adresse“: Die Adresse antwortet, aber nicht mit der Planka-2-API: Prüfe Port, Pfadpräfix oder die Planka-Version.
  • „Die Adresse leitet um“: Gib die https://-Adresse ein.
  • „Dieser Benutzer darf das nicht“: Der Benutzer ist nur Betrachter des Boards.
  • Ein Board fehlt: Der Benutzer muss Mitglied des Boards sein (oder sein Projekt verwalten); ein unter Verfolgte Boards eingegebener Name ohne passendes Board wird ignoriert, und Verbindung testen nennt ihn. Ab 20 Boards: Liste die zu verfolgenden auf.
  • „Mehrere Karten haben diesen Namen“: Gib das Board oder die ID der Karte an.
  • Protokolle: LOG_LEVEL=debug am Container zeigt jedes Lesen.

Grenzen​

  • Planka wird alle 1 bis 10 Minuten gelesen (und zu jeder Fälligkeit und um Mitternacht): Eine Änderung in Planka erscheint in Gladys innerhalb dieser Zeit. Webhooks und die Live-Verbindung von Planka werden nicht genutzt.
  • Eine Anfrage für die Projekte, plus eine pro verfolgtem Board, bei jedem Lesen.
  • Die Integration fügt Karten hinzu, verschiebt sie und hakt ihre Fälligkeiten ab; sie bearbeitet, löscht oder weist sie nicht zu und liest weder ihre Aufgaben noch Labels oder Kommentare.
  • Nur die ersten fünf aktiven Listen eines Boards bekommen einen Zähler.
  • Getestet mit Planka 2.2.1. Planka 1.x wird nicht unterstützt.
  • Gladys speichert keine Planka-Daten außer /data/planka-state.json (die Zeit des letzten Lesens und die Liste jeder Karte, damit kein Ereignis doppelt auslöst).
  • Nicht mit Planka oder der PLANKA Software GmbH verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Planka in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein PlankasectionNeinEin selbst gehostetes Planka 2. Gib einen API-Schlüssel (von einem Administrator erstellt) oder Benutzername und Passwort eines Benutzers an, der sich einmal in der Weboberfläche angemeldet hat.
AdressestringJaAdresse von Planka wie im Browser, mit https:// für HTTPS und :Port, falls nicht der Standard.
API-SchlüsselsecretNeinEmpfohlen. Administration, Benutzer, Menü des Benutzers, API-Schlüssel. Leer: Benutzername und Passwort unten werden verwendet.
Benutzername oder E-MailstringNeinOhne API-Schlüssel: ein Planka-Benutzer ohne Zwei-Faktor-Anmeldung.
PasswortsecretNein
OptionensectionNein
Verfolgte BoardsstringNeinNamen durch Kommas getrennt. Leer: alle Boards des Benutzers (höchstens 20). Ein Gerät pro verfolgtem Board.
Selbstsignierte Zertifikate akzeptierenbooleanNeinFür eine https://-Adresse mit selbstsigniertem Zertifikat. Nur für deinen eigenen Server aktivieren.
AktualisierungsintervallselectNeinWie oft Planka gelesen wird (eine Anfrage pro Board). Fälligkeiten und Mitternacht werden immer pünktlich verfolgt.
Sprache der FunktionsnamenselectNeinNamen der Funktionen beim Hinzufügen eines Geräts und an Szenen gesendete Texte.

So installierst du Planka in Gladys​

  1. Öffne in Gladys Integrationen: Planka erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-planka:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-planka.

Planka benötigt Gladys >=5.1.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​

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

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am