Intégration domotique Planka, gratuite et open source

Tableaux kanban Planka : cartes du jour et en retard, déplacements, ajout de cartes 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

Amenez les tableaux kanban de votre Planka dans Gladys : les cartes dues aujourd'hui, celles en retard, la prochaine échéance et le nombre de cartes de chaque liste d'un tableau. Une scène réagit quand une carte arrive dans une liste (Fait, À vérifier…) ou arrive à échéance, une autre ajoute « acheter du pain » depuis un bouton ou déplace une carte depuis un tag NFC, un appui sur le tableau de bord coche une échéance, et Gladys peut lire les cartes du jour chaque matin.

Vos retours sont les bienvenus. Cette intégration a été testée contre un vrai serveur Planka (image Docker ghcr.io/plankanban/planka 2.2.1, octobre 2026), pas encore à l'usage au quotidien. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Ce qu'il faut

• Gladys Assistant 5.1.0 ou plus récent.
• Un Planka 2 auto-hébergé (testé avec la 2.2.1), joignable depuis Gladys. Planka 1.x n'est pas pris en charge : son API est différente.
• L'un des deux, pour un utilisateur de Planka membre des tableaux à suivre :
  • une clé d'API (recommandé) : un administrateur la crée dans Planka, Administration → Utilisateurs → menu de l'utilisateur → Clé API → Créer une clé API. Copiez-la : Planka ne l'affiche qu'une fois. Elle marche aussi avec la connexion à deux facteurs et l'authentification unique ;
  • ou l'identifiant (ou l'e-mail) et le mot de passe de l'utilisateur. Il doit s'être connecté une fois à l'interface web, pour accepter les conditions que Planka demande à la première connexion, et ne pas utiliser la connexion à deux facteurs.

L'intégration voit les tableaux que voit cet utilisateur, et agit en son nom. Un utilisateur simple lecteur d'un tableau peut le suivre, mais pas en ajouter ni en déplacer les cartes.

Configuration

1. Dans Gladys, Intégrations → installez Planka.
2. Dans l'écran Configuration, renseignez :
   • Adresse : l'adresse de Planka comme dans le navigateur, par exemple http://192.168.1.20:3000, ou https://kanban.example.org derrière un proxy inverse (un préfixe comme /planka est conservé) ;
   • Clé d'API, ou Identifiant ou e-mail et Mot de passe. Quand la clé d'API est remplie, c'est elle qui sert.
3. Options :
   • Tableaux suivis : des noms séparés par des virgules (Maison, Courses), ou le numéro d'un tableau (celui de son adresse). Vide : tous les tableaux de l'utilisateur, 20 au plus ;
   • Accepter les certificats auto-signés : pour une adresse en https:// avec un certificat auto-signé, sur votre propre serveur seulement ;
   • Intervalle de rafraîchissement : 1 à 10 minutes (5 par défaut). Les échéances 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 d'un appareil (français par défaut), et les textes envoyés aux scènes.
4. Enregistrez, puis Tester la connexion : elle lit Planka et donne le nombre de cartes ouvertes et de tableaux suivis.
5. Dans l'onglet Découverte, ajoutez les appareils voulus.

Appareils

Planka tableau pour chaque tableau suivi, avec ces fonctionnalités :

Fonctionnalité	Ce qu'elle indique
Cartes ouvertes	les cartes des listes actives (pas celles d'une liste fermée comme Fait, ni les archivées)
Cartes dues aujourd'hui	les cartes ouvertes dont l'échéance tombe aujourd'hui, passée ou non, sans case cochée
Cartes en retard	les cartes ouvertes dont l'échéance est passée, sans case cochée
une par liste	le nombre de cartes de chacune des cinq premières listes actives, au nom de la liste
Prochaine échéance	la carte dont l'échéance à venir est la plus proche, et sa date ; Aucune s'il n'y en a pas

« Aujourd'hui » est le jour dans le fuseau horaire de Gladys. Une carte dont la case d'échéance est cochée, ou qui est dans une liste fermée (le genre de liste « Fait » de Planka), n'est plus due. Les noms des fonctionnalités sont fixés à l'ajout de l'appareil : une liste renommée ensuite garde son ancien nom dans Gladys. Une nouvelle liste parmi les cinq premières fait proposer la mise à jour de l'appareil dans l'onglet Découverte.

Tableau de bord

Le widget Cartes du jour affiche deux tuiles (aujourd'hui, en retard), la liste des cartes à finir ce soir, les retards d'abord, avec leur heure, leur liste et leur tableau, et un bouton pour chacune des quatre plus urgentes : un appui coche l'échéance de la carte dans Planka. Choisissez un appareil tableau dans les réglages du widget pour ne voir que ses cartes ; laissez vide pour tous les tableaux suivis. Quand rien n'est dû, 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.

Scènes

Déclencheurs

• Carte Planka déplacée : une carte est arrivée dans une autre liste de son tableau. Filtres : le tableau (un appareil tableau), le nom de la liste, exactement comme dans Planka (Fait). Informations transmises aux actions : la carte, son numéro, son tableau, sa liste, la liste précédente, son échéance.
• Carte Planka à échéance : une carte ouverte a atteint son échéance, sans que la case soit cochée.
• Carte Planka en retard : à minuit, une carte due ce jour-là n'est toujours pas faite. Une fois par carte et par échéance.

Filtres des deux derniers : le tableau, le nom de la carte. Informations transmises aux actions : la carte, son numéro, son tableau, sa liste, son échéance.

Un déplacement est vu à la lecture suivante : dans l'intervalle de rafraîchissement. Une carte créée, ou venue d'un autre tableau, n'est pas un déplacement. Une carte faite avant son échéance ne déclenche rien, et une échéance reculée à la main avant la lecture précédente non plus. Un redémarrage ne déclenche rien deux fois ; un déplacement fait pendant l'arrêt de l'intégration se déclenche à son redémarrage, et une échéance passée depuis moins d'une heure aussi.

Actions

• Ajouter une carte Planka : un titre ; le tableau par son nom (vide : le premier tableau suivi) ; la liste par son nom (vide : sa première liste active) ; une échéance facultative, à l'heure de Gladys : 2026-10-24 18:00, 2026-10-24 (midi), ou à partir de maintenant +30m, +2h, +3d. La carte va en bas de la liste. Résultats : la carte, son numéro, son tableau, sa liste, son échéance.
• Déplacer une carte Planka : la carte par son nom exact (majuscules et accents ignorés) ou son numéro, la liste de destination par son nom, et le tableau si deux tableaux ont une carte de ce nom. La carte va en bas de la liste ; une carte d'une liste fermée peut revenir. Résultats : la carte, son numéro, son tableau, sa liste, la liste précédente.
• Lire les cartes Planka du jour : les cartes à finir ce soir en une phrase (3 carte(s) à finir ce soir : …. 2 en retard.), pour tous les tableaux suivis ou l'un d'eux. Résultats : la phrase, le nombre de cartes à finir ce soir, de cartes en retard. Envoyez la phrase dans un message, ou faites-la dire à Gladys.

Les champs acceptent les variables de scène : {{triggerEvent.data.card}} déplace la carte qui a déclenché la scène.

Idées de scènes

• À 7 h 30, Lire les cartes Planka du jour, puis envoyer la phrase sur Telegram.
• Carte Planka déplacée dans la liste Fait du tableau Maison : envoyer « bravo » à la famille, ou éteindre la lampe de rappel.
• Quand le lave-linge s'arrête, Ajouter une carte Planka Étendre le linge dans À faire, échéance +1h.
• Un tag NFC sur les poubelles lance Déplacer une carte Planka Sortir les poubelles vers Fait.

Dépannage

• « Planka ne répond pas » : vérifiez l'adresse et le port depuis la machine de Gladys (l'adresse ouvre Planka dans un navigateur).
• « Clé d'API, identifiant ou mot de passe refusé » : la clé a été régénérée ou supprimée, ou le mot de passe a changé. Créez une nouvelle clé.
• « Connectez-vous une fois dans l'interface de Planka pour accepter ses conditions » : connectez-vous une fois avec cet utilisateur dans le navigateur, acceptez les conditions, puis Tester la connexion à nouveau.
• « Connexion à deux facteurs : utilisez plutôt une clé d'API » : un utilisateur à deux facteurs ne peut pas se connecter depuis Gladys avec un mot de passe.
• « Aucune API Planka 2 à cette adresse » : l'adresse répond, mais pas avec l'API de Planka 2 : vérifiez le port, le préfixe, ou la version de Planka.
• « L'adresse redirige » : saisissez l'adresse en https://.
• « Cet utilisateur n'a pas ce droit » : l'utilisateur n'est que lecteur du tableau.
• Un tableau manque : l'utilisateur doit être membre du tableau (ou gérer son projet) ; un nom saisi dans Tableaux suivis qui ne correspond à aucun tableau est ignoré, et Tester la connexion l'indique. Au-delà de 20 tableaux, listez ceux à suivre.
• « Plusieurs cartes portent ce nom » : indiquez le tableau, ou le numéro de la carte.
• Logs : LOG_LEVEL=debug sur le conteneur montre chaque lecture.

Limites

• Planka est lu toutes les 1 à 10 minutes (et à chaque échéance et à minuit) : un changement dans Planka apparaît dans Gladys dans ce délai. Les webhooks de Planka et sa connexion en direct ne sont pas utilisés.
• Une requête pour les projets, plus une par tableau suivi, à chaque lecture.
• L'intégration ajoute des cartes, les déplace et coche leurs échéances ; elle ne les modifie pas, ne les supprime pas, ne les assigne pas, et ne lit ni leurs tâches, ni leurs étiquettes, ni leurs commentaires.
• Seules les cinq premières listes actives d'un tableau ont un compteur.
• Testée avec Planka 2.2.1. Planka 1.x n'est pas pris en charge.
• Gladys ne garde aucune donnée de Planka hors de /data/planka-state.json (l'heure de la dernière lecture et la liste de chaque carte, pour qu'aucun événement ne parte deux fois).
• Sans lien avec Planka ni PLANKA Software GmbH.

Paramètres de configuration

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

Paramètre	Type	Obligatoire	Description
Votre Planka	section	Non	Un Planka 2 auto-hébergé. Donnez une clé d'API (créée par un administrateur), ou l'identifiant et le mot de passe d'un utilisateur déjà connecté une fois à l'interface.
Adresse	string	Oui	Adresse de Planka, comme dans le navigateur, avec https:// pour le HTTPS et :port s'il n'est pas celui par défaut.
Clé d'API	secret	Non	Recommandé. Administration, Utilisateurs, menu de l'utilisateur, clé d'API. Vide : l'identifiant et le mot de passe ci-dessous servent.
Identifiant ou e-mail	string	Non	Sans clé d'API : un utilisateur de Planka sans connexion à deux facteurs.
Mot de passe	secret	Non
Options	section	Non
Tableaux suivis	string	Non	Noms séparés par des virgules. Vide : tous les tableaux de l'utilisateur (20 au plus). Un appareil par tableau suivi.
Accepter les certificats auto-signés	boolean	Non	Pour une adresse en https:// dont le certificat est auto-signé. À cocher seulement pour votre propre serveur.
Intervalle de rafraîchissement	select	Non	Fréquence de lecture de Planka (une requête par tableau). 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 d'un appareil, et textes envoyés aux scènes.

Comment installer Planka dans Gladys

1. Dans Gladys, ouvrez Intégrations : Planka 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-planka: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-planka.

Planka 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

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