Der neue Monatsrückblick für Mai und Juni 2026 ist online!

[bmueller]

Hallo zusammen,

ich möchte euch gerne meinen selbst entwickelten KanBan-Adapter vorstellen.

Der Auslöser war banal. Bei uns zu Hause hingen Aufgaben an Zetteln, in zwei verschiedenen Apps und im Kopf. Ich wollte eine gemeinsame Aufgabenverwaltung, die sich anfühlt wie ein normales Kanban-Board, aber eben ins Smart Home eingebunden, so dass Skripte oder meine lokalen KI-Agenten Karten anlegen und auch selbst abarbeiten können und ich das Board in mein Dashboard hängen kann.

Mangels Möglichkeiten habe ich mich also daran gemacht, selbst einen passenden Adapter zu entwickeln.

So sieht das Ganze aus:

Die Features

• Eigener Webserver (Standard-Port 8095) – die Oberfläche kommt direkt aus dem Adapter, für UI-Updates ist kein iobroker upload nötig
• Mehrere Boards mit frei konfigurierbaren Spalten möglich: Name, Reihenfolge, Anzeige-Limit, WIP-Limit, Kennzeichnung als „Neu"- und „Erledigt"-Spalte
• Karten mit Titel, Markdown-Beschreibung, Zuständigen Usern, Fälligkeitsdatum (optional mit Uhrzeit), Labels, Farbe, Priorität, Checkliste, Link, Ort und ics-Kalender-Einladung
• Wiederkehrende Aufgaben: täglich, wöchentlich, monatlich, jährlich, n-ter Wochentag, n-ter Arbeitstag inklusive Feiertagsberechnung (nutzt den feiertage-Adapter, wenn vorhanden)
• Drag & Drop mit Maus und Touch, Live-Sync über WebSocket
• Mehrbenutzerbetrieb ohne Login: Benutzerliste in den Instanzeinstellungen, Mitglieder je Board, die Chips in der Kopfzeile wirken als gespeicherter Personenfilter
• E-Mail-Benachrichtigungen über den email-Adapter bei Zuweisung, Fälligkeit und Kartenereignissen, einzeln pro Benutzer und Ereignis schaltbar, auf Wunsch mit .ics-Termin im Anhang
• Mehrsprachig (de, en, fr, nl, it), Datums- und Uhrzeitformat pro Instanz einstellbar, Theme hell/dunkel/automatisch, Akzentfarbe und eigenes CSS

Das Board läuft komplett lokal im iobroker, was mir sehr wichtig war, ist aber fähig, eingehende und ausgehende Möglichkeiten der Anbindung zu bieten:

• REST-API für Boards und Karten (Schreibzugriffe tokengeschützt)
• Eingehende Webhooks mit eigenen Tokens je Integration, dazu sendTo und ein action-State für Skripte
• Ausgehende Webhooks bei jedem Ereignis, z. B. Richtung Node-RED
• Spiegel-States je Board und Benutzer (cardCount, overdueCount, overdueList …), direkt für VIS oder Lovelace nutzbar
• iframe-tauglich mit ?embed=1, dazu ein Dialog, mit dem ihr gefilterte Ansichts-URLs für die Lovelace-Webpage-Card oder jede andere Visualisierung, die iframes einbinden kann, zusammenklicken könnt.

Ein Beispiel aus einem Skript zur Anlage einer Karte:

sendTo('kanban.0', 'addCard', {
    board: 'familie',
    title: 'Filter der Lüftung wechseln',
    due: '2026-08-01',
    assignees: ['bjoern']
});

Unterstützung für schmale Bildschirme (z.B. Smartphones)

Auf schmalen Bildschirmen stapeln sich die Spalten, statt nebeneinander angezeigt zu werden, Dialoge öffnen im Vollbild. Zum Verschieben haltet ihr eine Karte kurz gedrückt, beim Ziehen erscheint ein Schnellmenü mit den Zielspalten.

Installation

Der Adapter ist (noch) nicht im offiziellen ioBroker-Repository, Installation läuft direkt über GitHub:

iobroker url https://github.com/bmueller77/iobroker.kanban

Oder im Admin über Adapter → Octocat-Symbol → Reiter custom → obige URL eintragen. Danach eine Instanz kanban.0 anlegen und http://<host>:8095/ öffnen.

Voraussetzungen: js-controller ab 6.0.11, Node.js ab 18. Für E-Mails braucht es eine konfigurierte email-Instanz, für die Feiertagsberechnung optional den feiertage-Adapter.

Wie immer bei GitHub-Installationen: keine automatischen Updates, Aktualisieren geht über denselben Weg.

Was ihr wissen solltet

Ein paar Punkte, die ich lieber vorweg sage als in einem späteren Thread:

Die Oberfläche arbeitet ohne Login. Schreibzugriffe sind seit 0.1.1 tokengeschützt, das wehrt fremde Webseiten und Scanner ab aber ein Ersatz für Netztrennung ist es nicht. Der Adapter gehört ins LAN, für Zugriff von außen solltet ihr einen Reverse-Proxy mit Authentifizierung davorschalten. Sollte es genug Anfragen geben, könnte die Funktion ggf. in einer späteren Version kommen... ;-)

Es ist ein Erstlingswerk, entstanden aus eigenem Bedarf. Getestet habe ich ausgiebig, aber eben nur in meiner Umgebung.

Dokumentation

Eine ausführliche Doku liegt im Github-Repository, gegliedert nach Instanzeinstellungen, Board, Integration und Referenz unter:

Deutsch: https://github.com/bmueller77/iobroker.kanban/blob/main/docs/de/README.md
Englisch: https://github.com/bmueller77/iobroker.kanban/blob/main/docs/en/README.md

Release für die Installation (v0.2.1): https://github.com/bmueller77/iobroker.kanban/releases/tag/v0.2.1

Feedback?! - Ausdrücklich erwünscht

Ich würde mich freuen, wenn der eine oder andere reinschaut. Rückmeldungen sind ausdrücklich willkommen. Was fehlt euch, was ist unverständlich, was funktioniert bei euch anders als gedacht oder wo hat sich ein Bug eingeschlichen?

Auch Feature-Requests sind willkommen. Vielleicht habt ihr ja sinnvolle Ideen für weitere Funktionen, auf die ich nicht gekommen bin.

Hinweis: Bei der Entwicklung hatte ich Unterstützung von Claude, vor allem bei den Übersetzungen der Oberfläche und der Dokumentation sowie beim Testen und Gegenlesen. Sage ich dazu, weil ich es für fair halte.

Changelog:
0.2.0: First public release
0.2.1: Express 5, avatar upload fix, deep link in event, repo compliance

[arteck]

Agile Haushaltsführung.. RESPEKT :-)

[sigi234]

@bmueller

Cool, installation hat einwandfrei funktioniert. Erstes Bord erstellt.

[icebear]

Ich hab den Adapter jetzt auch mal installiert, läuft.
Hab dann mal ein Board angelegt und zwei Benutzer.

Ich kann allerdings keine Bilder auswählen, egal ob ich das original Bild nehme, oder es vorher schon verkleinere (auf 128x128px), es spielt auch keine Rolle ob .jpg oder .png, ich bekomme jedesmal die Meldung ' Upload fehlgeschlagen: Bild konnte nicht gelesen werden'.

[lyc]

Hab den Adapter auch mal installiert und ein wenig damit herumgespielt. Was mir auffällt, um diesen wirklich zu nutzen, "Termine" lassen sich nicht oder werden nicht sortiert, ich muss also alle Einträge durchsuchen was in den nächsten Tagen als Nächstes ansteht oder bis wann es erledigt werden muss. Ein verschieben von Aufgaben auf andere Board gibt es nicht, also nur neu anlegen. Bilder zum Benutzer hinzufügen gibt nur den Fehler "Upload fehlgeschlagen: Bild konnte nicht gelesen werden". Optional, wäre es super, dass es andere Benachrichtigungsmöglichkeiten direkt im Adapter gibt z. B. Pushover, Whatsapp, etc. Danke für das Teilen und testen lassen.

[bmueller]

Danke euch fürs Testen und das Feedback!

@icebear @lyc: Avatar-Upload ("Bild konnte nicht gelesen werden") Den Fehler konnte ich reproduzieren: Die Content-Security-Policy der Oberfläche blockiert das lokale Einlesen des Bildes. Der Fix kommt im nächsten Update.

@lyc: Sortierung Per Default gibt es bei Kanban bewusst keine automatische Sortierung: du schiebst die Karten selbst in die gewünschte Reihenfolge (klicken, halten, hoch/runter; geht auch per Touch am Handy). Eine automatische Sortierung wirft immer Fragen auf: nach Priorität? Nach Datum? Einträge ohne Datum oben oder unten? Nach Person? etc. pp.
Was ich mir aber gut vorstellen kann: ein optionaler Schalter „nach Fälligkeit sortieren" pro Spalte. Dann bleibt „manuell" der Standard und wer will, schaltet die Sortierung dazu. Alternativ (oder zusätzlich) ein Anfasser zum leichteren Verschieben, wie bei den Spalten in den Board-Einstellungen. Wie sind hier die Meinungen der Community?

@lyc – Karten auf ein anderes Board verschieben Guter Punkt, das gibt es aktuell nicht (nur neu anlegen). Nehme ich als Feature-Wunsch auf.

Was die Integration von Messengern oder Pushdiensten angeht... da hat natürlich jeder seine persönlichen Vorlieben. Wenn ich heute Whatsapp und Pushover nativ integriere, möchte morgen jemand Matrix, übermorgen ein anderer PushBullet und Signal oder Telegram... usw.
Daher würde ich das gerne anders lösen und diese Möglichkeit habt ihr bereits mit der Version 0.2.0: Der Adapter feuert bei jedem Ereignis einen ausgehenden Webhook und schreibt zusätzlich den State kanban.0.lastEvent (inklusive Board, Karte, Zuständigen und Fälligkeit). Damit kann sich jeder die Benachrichtigung per Skript oder Node-RED an jeden beliebigen Dienst (Pushover, Signal, Telegram, Pushbullet …) schicken lassen.

Hier ein fertiges JavaScript-Beispiel (Telegram), das auch in der Doku landen wird.

// ============================================================
//  Kanban  ->  messenger notifications (Telegram example)
//  Runs in the ioBroker JavaScript adapter.
//  Reacts to kanban.0.lastEvent and sends the assigned users a
//  message. The same pattern works with Pushover, Signal,
//  Pushbullet, WhatsApp ... - just swap the sendTo line.
// ============================================================

// ---- Configuration -----------------------------------------
const KANBAN    = 'kanban.0';                 // Kanban instance
const MESSENGER = 'telegram.0';               // messenger instance (Telegram here)
const BASE_URL  = 'http://192.168.1.10:8095'; // board base URL (fallback if the event has no link)

// Mapping: Kanban user id  ->  messenger chat id
// Key   = the Kanban user id (lowercase "name" as in card.assignees, e.g. "user1"), NOT the display name.
// Value = the recipient id (Telegram: the numeric "ID" column of telegram.0.communicate.users).
const USERS = {
    user1: '123456789',
    // user2: '234567890',
};

// Which events should trigger a message?
// Available: cardCreated, cardAssigned, cardUpdated, cardMoved, cardDone, cardDeleted, cardDue
// Tip: 'cardAssigned' + 'cardDue' is enough for most setups. Adding 'cardCreated'
//      sends an extra message when a card is created.
const EVENTS = ['cardAssigned', 'cardDue'];

// Skip the person who triggered the change? Uses ev.detail.by (the actor).
// Note: the board has NO login, so the web UI does not identify the actor -
// "by" is only filled for changes made via API / webhooks / scripts that pass
// a "by" field (e.g. your own agents). For plain clicks in the board UI this
// option therefore has no effect.
const SKIP_SELF = true;

// If a person has no messenger mapping: send to everyone? (false = skip)
const BROADCAST_IF_UNMAPPED = false;
// ------------------------------------------------------------

const HEADER = {
    cardAssigned: 'Assigned to you',
    cardDue:      'Due',
    cardCreated:  'New card',
    cardMoved:    'Moved',
    cardDone:     'Done',
    cardUpdated:  'Updated',
};
const PRIO = ['', 'Priority: High', 'Priority: Urgent'];

function buildText(ev) {
    const c = ev.card || {};
    const b = ev.board || {};
    const lines = ['[Kanban] ' + (HEADER[ev.event] || ev.event), ''];
    lines.push(c.title || '(no title)');
    lines.push('Board: ' + (b.title || b.id || '?'));
    if (c.due)      lines.push('Due: ' + c.due + (c.dueTime ? ' ' + c.dueTime : ''));
    if (c.priority) lines.push(PRIO[c.priority]);
    // The adapter adds a ready-to-use deep link as ev.link; fall back to building one
    const link = ev.link || (c.id && b.id
        ? BASE_URL + '/?board=' + encodeURIComponent(b.id) + '&card=' + encodeURIComponent(c.id)
        : '');
    if (link) { lines.push(''); lines.push(link); }
    return lines.join('\n');
}

on({ id: KANBAN + '.lastEvent', change: 'any' }, (obj) => {
    let ev;
    try { ev = JSON.parse(obj.state.val); } catch (e) { return; }
    if (!ev || !EVENTS.includes(ev.event)) return;

    // Determine recipients
    let recipients;
    if (ev.event === 'cardAssigned' && ev.detail && ev.detail.assignee) {
        recipients = [ev.detail.assignee];                 // only the newly assigned person
    } else {
        recipients = (ev.card && ev.card.assignees) || []; // all assignees
    }

    // Optionally drop the person who triggered the change (no self-notification)
    const by = ev.detail && ev.detail.by;
    if (SKIP_SELF && by) recipients = recipients.filter(u => u !== by);
    if (!recipients.length) return;

    const text = buildText(ev);

    const already = new Set();
    for (const uid of recipients) {
        const chatId = USERS[uid];
        if (chatId) {
            if (already.has(chatId)) continue;
            already.add(chatId);
            sendTo(MESSENGER, { chatId: chatId, text: text }); // adjust to your messenger's sendTo parameters if needed
        } else if (BROADCAST_IF_UNMAPPED) {
            sendTo(MESSENGER, { text: text }); // adjust to your messenger's broadcast parameters if needed
        }
        // otherwise: no mapping -> skipped
    }
});

WhatsApp direkt einzubauen ist übrigens unpraktisch, weil der kostenlose WhatsApp-Adapter den API-Key an eine feste Empfängernummer (CallMeBot) bindet. Heisst, je User bräuchte man eine eigene Instanz.