Intégration domotique Todoist, gratuite et open source
Connecteur non officiel : vos tâches Todoist sur le tableau de bord et les scènes.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Connecteur non officiel, sans lien avec Doist (l'éditeur de Todoist). Il amène vos tâches Todoist dans Gladys : un widget de tableau de bord avec les tâches du jour, des actions de scène pour ajouter, terminer et lire des tâches, et des déclencheurs de scène quand une tâche arrive à échéance, est ajoutée ou terminée. Il utilise l'API officielle Todoist v1 avec votre jeton d'API personnel. Todoist est une marque de Doist.
Ce que vous obtenez
| Surface | Contenu |
|---|---|
| Widget | Tâches Todoist : les tâches du jour et en retard (ou d'un projet, ou de n'importe quel filtre Todoist), avec la couleur de priorité, l'heure d'échéance et la mention de retard, un bouton pour cocher chaque tâche et un formulaire Ajouter |
| Actions de scène | ajouter une tâche (texte, échéance, projet, priorité, étiquettes, ou ajout rapide), terminer une tâche (nommée approximativement), lire des tâches (nombre, retards, la liste en texte, la prochaine tâche) |
| Déclencheurs de scène | tâche à échéance (à son heure, ou à l'heure choisie pour une date sans heure), tâche ajoutée, tâche terminée (récurrentes comprises), filtrés par projet et priorité |
Aucun appareil n'est créé : les tâches ne sont pas des appareils.
Installation
- Dans Todoist, ouvrez Paramètres → Intégrations → Développeur et copiez votre jeton d'API.
- Installez l'intégration, ouvrez sa configuration et collez le jeton. Il
n'est envoyé qu'à Todoist (
api.todoist.com), dans l'en-tête Authorization ; Gladys le stocke chiffré. - Cliquez sur Tester le compte : il affiche votre nombre de tâches et de projets, les tâches du jour et en retard, et le fuseau horaire de votre compte Todoist (celui dans lequel toutes les heures d'échéance sont lues).
- Placez le widget Tâches Todoist sur un tableau de bord. Laissez ses
réglages vides pour le jour et les retards, saisissez un filtre Todoist
(
#Courses,@courses,p1 & today) ou un nom de projet : le formulaire Ajouter place alors les nouvelles tâches dans ce projet.
Le widget
Chaque tâche affiche la couleur de sa priorité (rouge p1, orange p2, bleu p3, gris p4), son échéance (« 19:00 », « Demain », « mar. 20 oct. ») et, quand elle est en retard, « En retard ». Une carte contient au plus quatre boutons : jusqu'à trois tâches ont chacune leur bouton pour cocher (Gladys demande d'abord une confirmation) ; au-delà, les deux premières gardent le leur et Cocher… ouvre la liste de toutes. Ajouter ouvre un formulaire (tâche, échéance facultative écrite comme dans Todoist). Les formulaires nécessitent Gladys 5.2 ; les boutons pour cocher fonctionnent avec la 5.1.
Scènes
- Tâche à échéance : une tâche atteint son heure d'échéance. Une tâche due un jour sans heure se déclenche à l'heure réglée dans la configuration (Heure du déclencheur « tâche à échéance », 9 par défaut). Il se déclenche une fois par échéance ; les échéances déjà passées au démarrage de Gladys ne se déclenchent jamais.
- Tâche ajoutée : une tâche a été ajoutée dans Todoist (les applications, un projet partagé, un e-mail vers votre boîte de réception).
- Tâche terminée : une tâche a été cochée dans Todoist. Une tâche
récurrente compte aussi : Todoist la passe à sa date suivante, la variable
{{triggerEvent.data.recurring}}vaut alors vrai.
Chaque déclencheur peut être limité à un projet (saisi exactement comme
dans Todoist, majuscules comprises) et à certaines priorités. Variables :
{{triggerEvent.data.content}}, {{triggerEvent.data.project}},
{{triggerEvent.data.priority}} (p1 à p4), {{triggerEvent.data.due}}
(« 2026-10-14 19:00 »), {{triggerEvent.data.labels}},
{{triggerEvent.data.url}} (la tâche dans l'application web Todoist),
{{triggerEvent.data.all_day}}. Les modifications faites depuis Gladys (une
action de scène, le widget) ne déclenchent ni « tâche ajoutée » ni « tâche
terminée » : une scène ne peut pas boucler à travers l'intégration.
Les actions renvoient des valeurs pour les étapes suivantes. Les actions
suivantes de la scène les trouvent dans leur liste de variables (écrites
{{<étape>.<action>.<clé>}}, par exemple {{0.0.count}} quand
Lire des tâches est la première action de la scène) :
- Ajouter une tâche donne
id,url,projectetdue. L'échéance s'écrit comme dans Todoist (« demain à 18h », « tous les lundis ») ; un projet vide est votre boîte de réception. Avec l'ajout rapide, le texte est lu comme dans les applications Todoist (« Appeler maman demain 18h #Maison p2 ») et les autres champs sont ignorés. - Terminer une tâche ferme la tâche ouverte dont le texte correspond,
sans tenir compte des majuscules ni des accents (sinon la première qui
contient le texte, la plus urgente gagnant), éventuellement seulement dans
un projet ou un filtre.
donevaut faux si aucune tâche ne correspond. - Lire des tâches prend un filtre Todoist (
today | overduepar défaut) et donnecount,overdue_count,list(une ligne par tâche, dans la langue de votre compte Todoist) et la prochaine tâche :next_task,next_due,next_project,next_priority,next_url.
Les filtres autres que celui par défaut sont évalués par Todoist : écrivez-les dans la langue choisie dans Langue de vos filtres (anglais par défaut).
Rythme
Todoist publie ses limites : par utilisateur et par 15 minutes, 1000 synchronisations incrémentales et 100 complètes. L'intégration fait une synchronisation complète au démarrage, puis une synchronisation incrémentale légère toutes les 2 minutes (option Intervalle de synchronisation, 1 minute au minimum) tant que les tâches sont surveillées, et une juste après une modification faite depuis Gladys. « Tâche à échéance » est vérifié chaque minute sur les tâches synchronisées, sans aucune requête. Un filtre évalué par Todoist est gardé une minute. Chaque requête est comptée : l'intégration n'utilise jamais plus de la moitié des limites publiées et se met en pause quand Todoist demande de ralentir. Avec Surveiller les tâches désactivé, rien ne tourne en arrière-plan : le widget et les actions se synchronisent quand ils en ont besoin, et les déclencheurs ne se déclenchent jamais.
Dépannage
- « Todoist a refusé le jeton d'API » : recopiez le jeton et enregistrez la configuration ; l'intégration ne réessaie pas d'elle-même.
- « Todoist est injoignable » : elle réessaie à la synchronisation suivante.
- Un déclencheur ne se déclenche pas : vérifiez que les tâches sont surveillées et que le projet est écrit exactement comme dans Todoist.
- Les heures d'échéance sont décalées d'une ou deux heures : c'est le fuseau horaire de votre compte Todoist (Todoist : Paramètres → Général) qui est utilisé ; Tester le compte l'affiche.
- Journaux : le niveau de log de l'intégration se règle avec la variable
LOG_LEVEL.
Confidentialité
Le jeton d'API n'est envoyé qu'à Todoist, jamais journalisé. De votre compte, l'intégration garde en mémoire les tâches, les noms des projets, le fuseau horaire et la langue ; l'e-mail et les autres réglages envoyés par Todoist sont aussitôt écartés. Rien n'est écrit sur le disque.
Paramètres de configuration
Voici les paramètres demandés par Todoist dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Tâches Todoist | section | Non | Connecteur non officiel, sans lien avec Doist (l'éditeur de Todoist). Il lit votre compte Todoist avec votre jeton d'API personnel, disponible dans Todoist sous Paramètres > Intégrations > Développeur : le jeton n'est envoyé qu'à Todoist (api.todoist.com), stocké chiffré par Gladys et jamais journalisé. Vous obtenez un widget (les tâches du jour, cocher, ajouter), des actions de scène (ajouter une tâche, terminer une tâche, lire des tâches) et des déclencheurs de scène (tâche à échéance, tâche ajoutée, tâche terminée). Les tâches sont synchronisées de façon incrémentale (toutes les 2 minutes par défaut), très en dessous des limites publiées par Todoist. |
| Jeton d'API Todoist | secret | Oui | Todoist : Paramètres > Intégrations > Développeur > Copier le jeton d'API. Envoyé uniquement à Todoist. |
| Surveiller les tâches (nécessaire aux déclencheurs de scène) | boolean | Non | Synchronise les tâches en arrière-plan pour que « tâche à échéance », « tâche ajoutée » et « tâche terminée » fonctionnent. Désactivé : aucun appel en arrière-plan, le widget et les actions de scène lisent Todoist quand ils en ont besoin. |
| Intervalle de synchronisation (minutes) | number | Non | Fréquence de lecture des changements (une requête légère). Une modification faite depuis Gladys est relue aussitôt. |
| Heure du déclencheur « tâche à échéance » pour une date sans heure | number | Non | Une tâche due un jour sans heure déclenche « tâche à échéance » à cette heure (0 à 23, fuseau horaire de votre compte Todoist). |
| Langue de vos filtres | select | Non | La langue dans laquelle vous écrivez les filtres Todoist, dans le widget et les scènes (« today | overdue » est en anglais, « aujourd'hui | en retard » en français). |
Comment installer Todoist dans Gladys
- Dans Gladys, ouvrez Intégrations : Todoist apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-todoist:0.1.1), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-todoist.
Todoist 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
Todoist 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 LM1LC3N7, 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