Zum Hauptinhalt springen

Mindwtr Smart-Home-Integration, kostenlos und Open Source

Mindwtr-Integration für Gladys Assistant

Mindwtr-GTD-Aufgaben über den Sync-Server: Eingang, heute, überfällig, Erfassen per Szene.

Deine Mindwtr-Aufgaben (die freie GTD-App) in Gladys: was im Eingang wartet, deine nächsten Schritte, was heute fällig oder überfällig ist. Eine Szene reagiert, wenn eine Aufgabe fällig wird oder der Eingang auf seine Durchsicht wartet, eine andere erfasst „Brot kaufen“ per Taster oder Sprachbefehl, ein Tippen im Dashboard erledigt eine Aufgabe, und Gladys kann jeden Morgen die heutigen Aufgaben vorlesen.

Feedback willkommen. Diese Integration wurde mit einem echten Mindwtr-Sync-Server getestet (Docker-Image ghcr.io/dongdongbh/mindwtr-cloud 1.3.6, Oktober 2026), aber 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.
  • Den selbst gehosteten Sync-Server von Mindwtr, mindwtr-cloud (siehe die Docker-Anleitung von Mindwtr), von Gladys aus erreichbar. Er lauscht auf Port 8787.
  • Deine Mindwtr-Apps (Desktop, Handy, Web-App), mit diesem Server synchronisiert: Settings → Sync → Self-Hosted.

Nur die Synchronisation über diesen Server funktioniert. Wenn deine Apps über Dropbox, WebDAV, iCloud oder einen geteilten Ordner synchronisieren, hat die Integration nichts zu lesen: Mindwtr bietet seine REST-API nur auf mindwtr-cloud an. Der Umstieg auf diesen Server braucht einen Docker-Container und ein Token.

Die Integration liest und schreibt über die REST-API des Servers (/v1/tasks), mit demselben Token wie die Apps. Das Sync-Dokument (/v1/data) fasst sie nie an: Hinzugefügte und erledigte Aufgaben laufen über den Server, der sie wie die Apps zusammenführt, und erscheinen bei der nächsten Synchronisation auf deinen Geräten.

Installation​

  1. In Gladys Integrationen → Mindwtr installieren.
  2. Im Bildschirm Konfiguration eintragen:
    • Adresse: die „Self-Hosted URL“ deiner Apps, zum Beispiel http://192.168.1.20:8787, oder https://mindwtr.example.org hinter Caddy oder einem anderen Reverse-Proxy (ein Präfix wie /mindwtr bleibt erhalten; /v1/data am Ende wird entfernt). Es ist der Port des Servers, nicht der der Web-App (5173);
    • Sync-Token: das Token aus deinen Apps, eines der Tokens von MINDWTR_CLOUD_AUTH_TOKENS des Servers. Jedes Token hat seine eigene Aufgabenliste: Nimm das der Liste, der du folgen willst.
  3. Optionen:
    • Eingangs-Durchsicht nach: die Dauer des Auslösers Mindwtr-Eingang durchsehen (standardmäßig 24 Stunden, von 4 Stunden bis 1 Woche);
    • Selbstsignierte Zertifikate akzeptieren: für eine https://-Adresse mit selbstsigniertem Zertifikat (zum Beispiel die lokale CA von Caddy), nur für deinen eigenen Server;
    • Aktualisierungsintervall: 1 bis 10 Minuten (standardmäßig 5). Fälligkeiten, die Eingangs-Durchsicht und Mitternacht werden immer pünktlich berücksichtigt, egal welches Intervall;
    • Sprache der Funktionsnamen: die Namen der Funktionen beim Hinzufügen des Geräts (standardmäßig Französisch) und die an Szenen gesendeten Texte.
  4. Speichern, dann Verbindung testen: Die Integration liest den Server und nennt die Zahl der offenen Aufgaben und der Aufgaben im Eingang.
  5. Im Tab Entdecken das Gerät Mindwtr hinzufügen.

Gerät​

Ein Gerät Mindwtr mit sieben Funktionen:

FunktionWas sie anzeigt
Aufgaben im Eingangdie erfassten, noch nicht geklärten Aufgaben (Liste Inbox)
Nächste Schrittedie Aufgaben der Liste Next
Wartet aufdie Aufgaben der Liste Waiting (was du von jemandem erwartest)
Überfällige Aufgabendie offenen Aufgaben, deren Fälligkeit vorbei ist
Heute fällige Aufgabendie heute fälligen offenen Aufgaben, ob ihre Uhrzeit vorbei ist oder nicht
Heute erledigte Aufgabendie seit Mitternacht erledigten Aufgaben, in einer App oder über Gladys
Nächste Fälligkeitdie offene Aufgabe mit der nächsten noch kommenden Fälligkeit, und wann (Müll rausbringen · 19:00); sonst Keine

Eine offene Aufgabe ist weder erledigt, archiviert, gelöscht noch eine Notiz der Liste Reference. Eine Fälligkeit ohne Uhrzeit gilt bis zum Ende dieses Tages, wie in den Apps: Die Aufgabe ist erst ab Mitternacht überfällig. „Heute“ und die Uhrzeiten sind die der Zeitzone von Gladys: Mindwtr speichert Fälligkeiten ohne Zeitzone, so wie du sie eingegeben hast.

Dashboard​

Das Widget Mindwtr: heute zeigt zwei Kacheln (heute fällig, überfällig), die Liste dessen, was heute noch übrig ist, überfällige zuerst, mit Uhrzeit und Kontexten jeder Aufgabe, und eine Taste für jede der vier dringendsten: Ein Tippen erledigt die Aufgabe. Wenn nichts übrig ist, sagt das Widget das und nennt die nächste Fälligkeit.

Die Zähler können auch wie jede Gerätefunktion ins Dashboard, und ihr Verlauf wird gespeichert.

Szenen​

Auslöser​

  • Mindwtr-Aufgabe fällig: Eine offene Aufgabe erreicht ihre Fälligkeit; bei einer Fälligkeit ohne Uhrzeit zu Beginn dieses Tages (um Mitternacht). Der Wert all_day sagt, welcher Fall vorliegt.
  • Mindwtr-Aufgabe überfällig: Um Mitternacht ist eine an diesem Tag fällige Aufgabe noch nicht erledigt. Einmal pro Aufgabe und Fälligkeit.
  • Mindwtr-Eingang durchsehen: Ein Eintrag wartet seit der eingestellten Dauer im Eingang (standardmäßig 24 Stunden). Der Auslöser kommt im selben Abstand wieder, bis der Eingang geleert wurde: die Erinnerung an die GTD-Durchsicht. Werte: die Zahl der Aufgaben im Eingang, die älteste, ihr Alter in Stunden.
  • Mindwtr-Aufgabe hinzugefügt: Eine neue Aufgabe erscheint, erfasst auf einem Handy, über die API oder über Gladys (from_gladys ist dann wahr, damit sich eine Szene nicht selbst wieder startet). Das nächste Vorkommen einer wiederkehrenden Aufgabe zählt nicht.

Filter: die GTD-Liste (Eingang, nächste Schritte, wartet auf, irgendwann/vielleicht) für die drei Aufgaben-Auslöser und der genaue Titel für die ersten beiden. An die Aktionen übergebene Werte: die Aufgabe, ihre ID, ihre Liste, ihre Kontexte, ihr Projekt, ihre Fälligkeit wie in Mindwtr (2026-10-21T19:00) und all_day.

Eine vor ihrer Fälligkeit erledigte Aufgabe löst nichts aus. Eine von Hand in die Vergangenheit verschobene Fälligkeit auch nicht: Es zählen nur Zeitpunkte, die vergehen, während die Integration läuft. Ein Neustart löst nichts doppelt aus; ein Zeitpunkt, der verging, während die Integration gestoppt war, löst beim Neustart aus, wenn er weniger als eine Stunde alt ist.

Aktionen​

  • Aufgabe zum Mindwtr-Eingang hinzufügen: ein Titel und, wenn du willst, eine Fälligkeit und Kontexte. Die Fälligkeit schreibst du 2026-10-25, 25.10., morgen, heute, optional mit Uhrzeit (morgen 18:30, 25.10. 9:00); eine nicht verstandene Fälligkeit lässt die Aktion scheitern, statt ein falsches Datum zu speichern. Kontexte schreibst du @zuhause oder zuhause, mehrere durch Leerzeichen oder Kommas getrennt. Der Titel bleibt, wie er ist: Ein # oder @ im Titel wird nicht ausgewertet. Ergebnisse: die Aufgabe, ihre ID, ihre Fälligkeit.
  • Mindwtr-Aufgabe erledigen: der genaue Titel einer offenen Aufgabe (Groß- und Kleinschreibung und Akzente egal) oder ihre ID ({{triggerEvent.data.task_id}} eines Auslösers). Eine wiederkehrende Aufgabe geht zu ihrem nächsten Vorkommen über, wie in den Apps. Ergebnisse: die Aufgabe, ihre ID.
  • Heutige Mindwtr-Aufgaben lesen: als Satz (4 Aufgabe(n) für heute: …. 2 überfällig. 2 im Eingang.), für alle Kontexte oder einen (@zuhause). Ergebnisse: der Satz, die Zahl der Aufgaben für heute (überfällige inklusive), der überfälligen Aufgaben, der Aufgaben im Eingang. Schick den Satz in einer Nachricht oder lass ihn von Gladys sagen.

Die Textfelder akzeptieren Szenenvariablen.

Szenen-Ideen​

  • Um 7:30 Heutige Mindwtr-Aufgaben lesen, dann den Satz per Telegram schicken oder vom Küchenlautsprecher sagen lassen.
  • Ein Taster an der Tür startet Aufgabe zum Mindwtr-Eingang hinzufügen mit Brot kaufen und dem Kontext @besorgungen.
  • Mindwtr-Eingang durchsehen am Sonntagabend: eine Nachricht „5 Einträge warten in deinem Eingang, der älteste seit 72 Stunden“.
  • Mindwtr-Aufgabe fällig mit dem Titel Müll rausbringen: das Licht im Flur blinken lassen; ein NFC-Tag an der Tonne startet Mindwtr-Aufgabe erledigen.

Fehlerbehebung​

  • „Der Sync-Server antwortet nicht“: Prüfe Adresse und Port vom Rechner von Gladys aus (http://<adresse>:8787/health antwortet {"ok":true}).
  • „Token abgelehnt“: Das Token steht nicht in MINDWTR_CLOUD_AUTH_TOKENS des Servers (falsch kopiert oder entfernt). Kopiere das aus den Sync-Einstellungen der App.
  • „Kein Mindwtr-Sync-Server unter dieser Adresse“: Die Adresse antwortet, aber nicht mit der API: oft der Port der Web-App (5173) statt des Servers (8787), oder ein Proxy mit Anmeldung (Authelia) vor /v1.
  • „Die Adresse leitet um“: Gib die https://-Adresse ein.
  • „Der Server kann seinen Datenordner nicht nutzen“: ein Problem des Servers selbst (Rechte des Volumes /app/cloud_data); seine Protokolle erklären es.
  • Die Zähler stehen auf null: Das Token wird akzeptiert, gehört aber zu einer anderen Liste (ein Token = eine Liste). Prüfe, dass es dasselbe wie in den Apps ist.
  • „Mehrere offene Aufgaben haben diesen Titel“: Benenne eine um oder nutze die ID aus einem Auslöser.
  • Protokolle: LOG_LEVEL=debug am Container zeigt jedes Lesen.

Grenzen​

  • Nur über den selbst gehosteten Sync-Server mindwtr-cloud: weder Dropbox, noch WebDAV, noch iCloud, noch eine lokale Datei.
  • Der Server wird alle 1 bis 10 Minuten gelesen (und zu jeder Fälligkeit, zur Eingangs-Durchsicht und um Mitternacht): Eine auf dem Handy erledigte Aufgabe erscheint in dieser Zeit in Gladys, sobald das Handy synchronisiert hat. Drei Anfragen pro Lesen (offene Aufgaben, erledigte Aufgaben, Projekte), plus eine pro Seite mit 500 Aufgaben; der Server erlaubt standardmäßig 120 pro Minute.
  • Die Integration fügt Aufgaben zum Eingang hinzu und erledigt Aufgaben; sie ändert, löscht oder verschiebt sie nicht.
  • Aufgaben der Liste Reference werden nicht gezählt. Bereiche (Areas) werden nicht genutzt.
  • Getestet mit mindwtr-cloud 1.3.6.
  • Gladys speichert keine Mindwtr-Daten außer /data/mindwtr-state.json: die Zeit des letzten Lesens, die IDs der offenen Aufgaben und die Zeit der letzten Durchsicht, damit kein Ereignis doppelt ausgelöst wird. Das Token steht nicht darin.
  • Keine Verbindung zum Mindwtr-Projekt.

Konfigurationseinstellungen​

Diese Einstellungen fragt Mindwtr in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein Mindwtr-Sync-ServersectionNeinDer selbst gehostete Sync-Server von Mindwtr (mindwtr-cloud, Docker-Image). Dropbox- und WebDAV-Sync gehen nicht: Die Integration braucht diesen Server.
AdressestringJaDie Self-Hosted-URL aus den Sync-Einstellungen der App, mit :Port (standardmäßig 8787) und https:// für HTTPS.
Sync-TokensecretJaDas Token aus den Sync-Einstellungen der App, eines der MINDWTR_CLOUD_AUTH_TOKENS des Servers. Jedes Token hat seine eigene Aufgabenliste.
OptionensectionNein
Eingangs-Durchsicht nachselectNeinDas Szenen-Ereignis „Eingang durchsehen“ wird ausgelöst, wenn ein Eintrag so lange im Eingang wartet, dann im selben Abstand, bis der Eingang leer ist.
Selbstsignierte Zertifikate akzeptierenbooleanNeinFür eine https://-Adresse mit selbstsigniertem Zertifikat (lokale CA von Caddy). Nur für deinen eigenen Server aktivieren.
AktualisierungsintervallselectNeinWie oft der Server gelesen wird. Fälligkeiten und Mitternacht werden immer pünktlich berücksichtigt.
Sprache der FunktionsnamenselectNeinNamen der Funktionen beim Hinzufügen des Geräts und an Szenen gesendete Texte.

So installierst du Mindwtr in Gladys​

  1. Öffne in Gladys Integrationen: Mindwtr 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-mindwtr: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-mindwtr.

Mindwtr 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​

Mindwtr 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 🙂