Intégration domotique Mindwtr, gratuite et open source

Tâches GTD Mindwtr par son serveur de synchro : boîte de réception, jour, retard, ajout par scène.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Vos tâches Mindwtr (l'appli GTD libre) dans Gladys : ce qui attend dans la boîte de réception, vos prochaines actions, ce qui est dû aujourd'hui ou en retard. Une scène réagit quand une tâche arrive à échéance ou que la boîte de réception attend sa revue, une autre capture « acheter du pain » depuis un bouton ou une commande vocale, un appui sur le tableau de bord termine une tâche, et Gladys peut lire les tâches du jour chaque matin.

Vos retours sont les bienvenus. Cette intégration a été testée contre un vrai serveur de synchronisation Mindwtr (image Docker ghcr.io/dongdongbh/mindwtr-cloud 1.3.6, octobre 2026), pas encore au quotidien. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Ce qu'il vous faut

• Gladys Assistant 5.1.0 ou plus récent.
• Le serveur de synchronisation auto-hébergé de Mindwtr, mindwtr-cloud (voir le guide Docker de Mindwtr), joignable depuis Gladys. Il écoute sur le port 8787.
• Vos applis Mindwtr (ordinateur, téléphone, appli web) synchronisées avec ce serveur : Réglages → Sync → Self-Hosted.

Seule la synchronisation par ce serveur convient. Si vos applis se synchronisent par Dropbox, WebDAV, iCloud ou un dossier partagé, l'intégration n'a rien à lire : Mindwtr n'expose son API REST que sur mindwtr-cloud. Passer à ce serveur ne demande qu'un conteneur Docker et un jeton.

L'intégration lit et écrit par l'API REST du serveur (/v1/tasks), avec le même jeton que les applis. Elle ne touche jamais au document de synchronisation (/v1/data) : les ajouts et les tâches terminées passent par le serveur, qui les fusionne comme le font les applis, et apparaissent sur vos appareils à leur prochaine synchronisation.

Installation

1. Dans Gladys, Intégrations → installez Mindwtr.
2. Dans l'écran Configuration, renseignez :
   • Adresse : l'« URL Self-Hosted » de vos applis, par exemple http://192.168.1.20:8787, ou https://mindwtr.example.org derrière Caddy ou un autre proxy inverse (un préfixe comme /mindwtr est conservé ; /v1/data en fin d'adresse est retiré). C'est le port du serveur, pas celui de l'appli web (5173) ;
   • Jeton de synchronisation : le jeton saisi dans vos applis, l'un des jetons de MINDWTR_CLOUD_AUTH_TOKENS du serveur. Chaque jeton a sa propre liste de tâches : prenez celui de la liste à suivre.
3. Options :
   • Revue de la boîte de réception après : le délai du déclencheur Boîte de réception Mindwtr à traiter (24 heures par défaut, de 4 heures à 1 semaine) ;
   • Accepter les certificats auto-signés : pour une adresse en https:// au certificat auto-signé (l'autorité locale de Caddy, par exemple), sur votre propre serveur seulement ;
   • Intervalle de rafraîchissement : 1 à 10 minutes (5 par défaut). Les échéances, la revue de la boîte de réception et minuit sont toujours suivis à l'heure, quel que soit l'intervalle ;
   • Langue des noms de fonctionnalités : les noms donnés aux fonctionnalités à l'ajout de l'appareil (français par défaut), et les textes envoyés aux scènes.
4. Enregistrez, puis Tester la connexion : l'intégration lit le serveur et donne le nombre de tâches ouvertes et de tâches dans la boîte de réception.
5. Dans l'onglet Découverte, ajoutez l'appareil Mindwtr.

Appareil

Un appareil Mindwtr, avec sept fonctionnalités :

Fonctionnalité	Ce qu'elle indique
Tâches dans la boîte de réception	les tâches capturées pas encore clarifiées (liste Inbox)
Prochaines actions	les tâches de la liste Next
En attente	les tâches de la liste Waiting (ce que vous attendez de quelqu'un)
Tâches en retard	les tâches ouvertes dont l'échéance est passée
Tâches dues aujourd'hui	les tâches ouvertes dues aujourd'hui, que leur heure soit passée ou non
Tâches terminées aujourd'hui	les tâches marquées terminées depuis minuit, dans une appli ou depuis Gladys
Prochaine échéance	la tâche ouverte à l'échéance la plus proche encore à venir et quand (Sortir les poubelles · 19:00) ; Aucune sinon

Une tâche ouverte n'est ni terminée, ni archivée, ni supprimée, ni une note de la liste Reference. Une échéance sans heure est due jusqu'à la fin de ce jour-là, comme dans les applis : la tâche n'est en retard qu'à partir de minuit. « Aujourd'hui » et les heures sont ceux du fuseau horaire de Gladys : Mindwtr enregistre les échéances sans fuseau, à l'heure où vous les avez saisies.

Tableau de bord

Le widget Mindwtr : aujourd'hui montre deux tuiles (dues aujourd'hui, en retard), la liste de ce qui reste pour aujourd'hui, en retard d'abord, avec l'heure et les contextes de chaque tâche, et un bouton pour chacune des quatre plus urgentes : un appui termine la tâche. Quand il ne reste rien, le widget le dit et donne la prochaine échéance.

Les compteurs peuvent aussi aller sur le tableau de bord comme toute fonctionnalité d'appareil, et leur historique est gardé.

Scènes

Déclencheurs

• Tâche Mindwtr arrivée à échéance : une tâche ouverte atteint son heure d'échéance ; pour une échéance sans heure, au début de ce jour-là (à minuit). L'information all_day dit lequel des deux.
• Tâche Mindwtr en retard : à minuit, une tâche due ce jour-là n'est toujours pas terminée. Une fois par tâche et par échéance.
• Boîte de réception Mindwtr à traiter : un élément attend dans la boîte de réception depuis le délai de la configuration (24 heures par défaut). Le déclencheur revient au même rythme tant que la boîte de réception n'a pas été vidée : c'est le rappel de la revue GTD. Informations : le nombre de tâches dans la boîte de réception, la plus ancienne, son âge en heures.
• Tâche Mindwtr ajoutée : une nouvelle tâche apparaît, capturée sur un téléphone, par l'API ou depuis Gladys (from_gladys vaut alors vrai, pour éviter qu'une scène se relance elle-même). La prochaine occurrence d'une tâche répétée ne compte pas.

Filtres : la liste GTD (boîte de réception, prochaines actions, en attente, un jour/peut-être) pour les trois déclencheurs de tâche, et le titre exact pour les deux premiers. Informations transmises aux actions : la tâche, son identifiant, sa liste, ses contextes, son projet, son échéance telle que dans Mindwtr (2026-10-21T19:00) et all_day.

Une tâche terminée avant son échéance ne déclenche rien. Une échéance déplacée à la main dans le passé non plus : seuls comptent les moments qui passent pendant que l'intégration tourne. Un redémarrage ne déclenche rien deux fois ; un moment passé pendant que l'intégration était arrêtée déclenche à son redémarrage, s'il date de moins d'une heure.

Actions

• Ajouter une tâche dans la boîte de réception Mindwtr : un titre, et si vous voulez une échéance et des contextes. L'échéance s'écrit 2026-10-25, 25/10, demain, aujourd'hui, éventuellement suivie d'une heure (demain 18h30, 25/10 9:00) ; une échéance incomprise fait échouer l'action plutôt que d'enregistrer une date fausse. Les contextes s'écrivent @maison ou maison, plusieurs séparés par des espaces ou des virgules. Le titre est gardé tel quel : un # ou un @ dans le titre n'est pas interprété. Résultats : la tâche, son identifiant, son échéance.
• Terminer une tâche Mindwtr : le titre exact d'une tâche ouverte (majuscules et accents ignorés), ou son identifiant ({{triggerEvent.data.task_id}} d'un déclencheur). Une tâche répétée passe à son occurrence suivante, comme dans les applis. Résultats : la tâche, son identifiant.
• Lire les tâches Mindwtr du jour : en une phrase (4 tâche(s) pour aujourd'hui : …. 2 en retard. 2 dans la boîte de réception.), pour tous les contextes ou un seul (@maison). Résultats : la phrase, le nombre de tâches du jour (retards compris), de tâches en retard, de tâches dans la boîte de réception. Envoyez la phrase dans un message, ou faites-la dire par Gladys.

Les champs texte acceptent les variables de scène.

Idées de scènes

• À 7 h 30, Lire les tâches Mindwtr du jour, puis envoyer la phrase sur Telegram ou la faire dire par l'enceinte de la cuisine.
• Un bouton près de la porte lance Ajouter une tâche dans la boîte de réception Mindwtr avec Acheter du pain et le contexte @courses.
• Boîte de réception Mindwtr à traiter le dimanche soir : un message « 5 éléments attendent dans ta boîte de réception, la plus ancienne depuis 72 heures ».
• Tâche Mindwtr arrivée à échéance avec le titre Sortir les poubelles : faire clignoter la lumière de l'entrée ; un tag NFC sur la poubelle lance Terminer une tâche Mindwtr.

Dépannage

• « Le serveur de synchronisation ne répond pas » : vérifiez l'adresse et le port depuis la machine de Gladys (http://<adresse>:8787/health répond {"ok":true}).
• « Jeton refusé » : le jeton n'est pas dans MINDWTR_CLOUD_AUTH_TOKENS du serveur (mal copié, ou retiré). Copiez celui des réglages de synchronisation de l'appli.
• « Aucun serveur de synchronisation Mindwtr à cette adresse » : l'adresse répond, mais pas avec l'API : c'est souvent le port de l'appli web (5173) au lieu de celui du serveur (8787), ou un proxy qui demande une connexion (Authelia) devant /v1.
• « L'adresse redirige » : saisissez l'adresse en https://.
• « Le serveur ne peut pas utiliser son dossier de données » : un problème du serveur lui-même (droits du volume /app/cloud_data) ; ses journaux l'expliquent.
• Les compteurs sont à zéro : le jeton est bien accepté, mais c'est celui d'une autre liste (un jeton = une liste). Vérifiez qu'il est identique à celui des applis.
• « Plusieurs tâches ouvertes portent ce titre » : renommez l'une d'elles, ou utilisez l'identifiant donné par un déclencheur.
• Journaux : LOG_LEVEL=debug sur le conteneur montre chaque lecture.

Limites

• Uniquement par le serveur de synchronisation auto-hébergé mindwtr-cloud : ni Dropbox, ni WebDAV, ni iCloud, ni fichier local.
• Le serveur est lu toutes les 1 à 10 minutes (et à chaque échéance, à la revue de la boîte de réception et à minuit) : une tâche terminée sur le téléphone apparaît dans Gladys dans ce délai, une fois le téléphone synchronisé. Trois requêtes par lecture (tâches ouvertes, tâches terminées, projets), plus une par page de 500 tâches ; le serveur en accepte 120 par minute par défaut.
• L'intégration ajoute des tâches dans la boîte de réception et termine des tâches ; elle ne les modifie, ne les supprime ni ne les déplace.
• Les tâches au statut Reference ne sont pas comptées. Les zones (areas) ne sont pas utilisées.
• Testée avec mindwtr-cloud 1.3.6.
• Gladys ne garde aucune donnée de Mindwtr hormis /data/mindwtr-state.json : l'heure de la dernière lecture, les identifiants des tâches ouvertes et l'heure de la dernière revue, pour qu'aucun événement ne parte deux fois. Le jeton n'y est pas.
• Sans lien avec le projet Mindwtr.

Paramètres de configuration

Voici les paramètres demandés par Mindwtr dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Votre serveur de synchronisation Mindwtr	section	Non	Le serveur de synchronisation auto-hébergé de Mindwtr (mindwtr-cloud, image Docker). Les synchros Dropbox et WebDAV ne conviennent pas : il faut ce serveur.
Adresse	string	Oui	L'URL « Self-Hosted » des réglages de synchronisation de l'appli, avec :port (8787 par défaut) et https:// pour le HTTPS.
Jeton de synchronisation	secret	Oui	Le jeton des réglages de synchronisation de l'appli, l'un des MINDWTR_CLOUD_AUTH_TOKENS du serveur. Chaque jeton a sa propre liste de tâches.
Options	section	Non
Revue de la boîte de réception après	select	Non	L'événement de scène « Boîte de réception à traiter » se déclenche quand un élément y attend depuis ce délai, puis au même rythme jusqu'à ce qu'elle soit vide.
Accepter les certificats auto-signés	boolean	Non	Pour une adresse en https:// dont le certificat est auto-signé (autorité locale de Caddy). À cocher pour votre propre serveur seulement.
Intervalle de rafraîchissement	select	Non	Fréquence de lecture du serveur. Les échéances et minuit sont toujours suivis à l'heure.
Langue des noms de fonctionnalités	select	Non	Noms donnés aux fonctionnalités à l'ajout de l'appareil, et textes envoyés aux scènes.

Comment installer Mindwtr dans Gladys

1. Dans Gladys, ouvrez Intégrations : Mindwtr apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-mindwtr:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-mindwtr.

Mindwtr nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Mindwtr est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂