Integración domótica Kanboard, gratuita y de código abierto

Tareas de Kanboard: abiertas, del día, atrasadas, cerradas o creadas desde una escena o el panel.

• Publicado por guim31
• Dispositivos
• Versión 1.0.0
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Las tareas de su Kanboard en Gladys: lo que queda por hacer hoy, lo que está atrasado, la próxima tarea de cada proyecto. Una escena reacciona cuando una tarea vence o sigue abierta a medianoche, otra añade «comprar pan, mañana» desde un botón, un toque en el panel cierra una tarea, y Gladys puede leer las tareas del día cada mañana.

Sus comentarios son bienvenidos. Esta integración se ha probado con un servidor Kanboard real (imagen Docker kanboard/kanboard v1.2.56, octubre de 2026), todavía no en el uso diario. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.

Lo que necesita

• Gladys Assistant 5.1.0 o posterior.
• Un Kanboard autoalojado (1.2 o posterior), accesible desde Gladys (la imagen Docker escucha en el puerto 80).
• Credenciales para su API, una de las dos:
  • el token de API de la aplicación: en Kanboard, Settings → API, copie el API token, con el nombre de usuario jsonrpc. Ve todos los proyectos de la instancia (privados incluidos) y hace falta un administrador para leerlo;
  • una cuenta de usuario: su nombre de usuario, y su contraseña o un token de acceso personal (Mi perfil → API; obligatorio si la autenticación en dos pasos está activa). Ve los proyectos de los que este usuario es miembro, y actúa en su nombre.

Instalación

1. En Gladys, Integraciones → instale Kanboard.
2. En la pantalla Configuración, rellene:
   • Dirección: la dirección de Kanboard, por ejemplo http://192.168.1.20:8080, o https://kanboard.example.org/kanboard si está en una subcarpeta (la dirección copiada desde un tablero también sirve);
   • Nombre de usuario: jsonrpc (por defecto) para el token de API de la aplicación, o su nombre de usuario de Kanboard;
   • Token de API o contraseña: el secreto correspondiente.
3. Opciones:
   • Proyectos seguidos: nombres o números separados por comas (Casa, 3). Vacío: todos los proyectos. Los proyectos inactivos (cerrados) nunca se siguen;
   • Aceptar certificados autofirmados: para una dirección https:// con certificado autofirmado, solo para su propio servidor;
   • Intervalo de actualización: de 1 a 10 minutos (5 por defecto). Los vencimientos y la medianoche se siguen siempre a tiempo, sea cual sea el intervalo;
   • Idioma de los nombres de funciones: los nombres de las funciones al añadir un dispositivo (francés por defecto), y los textos enviados a las escenas.
4. Guarde y luego Probar la conexión: la integración lee Kanboard e indica su versión, el número de tareas abiertas y de proyectos seguidos.
5. En la pestaña Descubrimiento, añada los dispositivos que desee.

Dispositivos

Kanboard (todos los proyectos seguidos juntos) y Kanboard proyecto para cada proyecto seguido. Cada uno tiene cuatro funciones:

Función	Lo que indica
Tareas abiertas	las tareas abiertas, con o sin vencimiento
Tareas para hoy	las tareas abiertas que vencen antes de medianoche, atrasadas incluidas: lo que queda para esta noche
Tareas atrasadas	las tareas abiertas cuya fecha y hora de vencimiento ya han pasado
Próxima tarea	el título de la tarea abierta con el vencimiento más próximo por venir; si no, Ninguna

«Hoy» es el día en la zona horaria de Gladys. En Kanboard un vencimiento siempre tiene hora: una fecha elegida sin hora toma la hora del momento en que se guardó.

Panel

El widget Tareas del día muestra dos mosaicos (para hoy, atrasadas), la lista de las tareas del día, atrasadas primero, con su hora (en naranja para la prioridad más alta del proyecto) y su proyecto, y un botón para cada una de las cuatro más urgentes: un toque cierra la tarea. Elija un dispositivo de proyecto en la configuración del widget para ver solo sus tareas; déjelo vacío para todos los proyectos seguidos. Cuando no queda nada, el widget lo dice y muestra la próxima tarea.

Los contadores también pueden ir al panel como cualquier función de dispositivo.

Escenas

Disparadores

• Tarea de Kanboard vencida: una tarea abierta ha llegado a su hora de vencimiento.
• Tarea de Kanboard atrasada: a medianoche, una tarea que vencía ese día sigue abierta. Una vez por tarea y vencimiento.

Filtros, para ambos: el proyecto (un dispositivo de proyecto: el dispositivo Kanboard no filtra nada, deje el campo vacío para todos los proyectos), el título de la tarea (exacto, con mayúsculas y acentos, a diferencia de las acciones). Información transmitida a las acciones: la tarea, su número, su proyecto, su prioridad (de 0 a 3 por defecto, configurada por proyecto en Kanboard), su vencimiento.

Una tarea cerrada antes de su vencimiento no dispara nada. Un vencimiento movido a mano antes de la lectura anterior tampoco dispara nada: solo cuentan los momentos que pasan mientras la integración funciona. Un reinicio no dispara nada dos veces; un momento que pasó mientras la integración estaba detenida se dispara al volver, si tiene menos de una hora.

Acciones

• Cerrar una tarea de Kanboard: indique el título exacto (sin distinguir mayúsculas ni acentos) o el número de la tarea (#12, que se muestra en la tarjeta en Kanboard). Cualquier tarea abierta que vean las credenciales, proyecto seguido o no. Una tarea que se repite «al cerrarse» deja su siguiente repetición, como en Kanboard. Resultados: la tarea, su número, su proyecto, el vencimiento de la siguiente repetición.
• Crear una tarea de Kanboard: un título, el proyecto por nombre o número (vacío: el primer proyecto seguido, por nombre), y un vencimiento opcional: 2026-10-25 18:00, 25/10/2026, hoy, mañana 9:00, +3 (dentro de tres días), o solo una hora para hoy; sin hora, las 18:00 (las 23:59 si ya han pasado las 18:00). Las palabras también funcionan en inglés, francés y alemán (tomorrow, demain, morgen). La fecha se lee en la zona horaria de Gladys, sea cual sea la de Kanboard. Resultados: la tarea, su número, su proyecto, su vencimiento.
• Leer las tareas de Kanboard del día: las tareas del día en una frase (5 tarea(s) para hoy: …. 2 atrasada(s).), para todos los proyectos seguidos o uno de ellos. Resultados: la frase, el número de tareas para hoy y de tareas atrasadas. Envíe la frase en un mensaje, o haga que Gladys la diga.

Los campos aceptan variables de escena: {{triggerEvent.data.task_id}} cierra la tarea que disparó la escena.

Ideas de escenas

• A las 7:30, Leer las tareas de Kanboard del día, y luego enviar la frase por Telegram.
• Tarea de Kanboard vencida en el proyecto Casa: hacer parpadear la luz de la entrada.
• Un botón junto a la puerta lanza Crear una tarea de Kanboard con Comprar pan en Compras, vencimiento mañana 9:00.
• Una etiqueta NFC en los cubos de basura lanza Cerrar una tarea de Kanboard con Sacar la basura.

Solución de problemas

• «Kanboard no responde»: compruebe la dirección y el puerto desde la máquina de Gladys (la dirección abre Kanboard en un navegador).
• «Nombre de usuario, token o contraseña rechazado»: con jsonrpc, vuelva a copiar el token de Settings → API (cambia al regenerarlo); con un usuario, compruebe la contraseña, o use un token de acceso personal si la autenticación en dos pasos está activa. Kanboard bloquea una cuenta tras varios fallos.
• «Acceso prohibido a este usuario»: el usuario no puede leer uno de los proyectos o llamar a un procedimiento. Un token de aplicación solo funciona con el nombre de usuario jsonrpc: con otro, se rechaza como una contraseña incorrecta.
• «No hay ninguna API de Kanboard en esta dirección»: la dirección responde, pero no con la API de Kanboard: compruebe el puerto y la subcarpeta.
• «La dirección redirige»: introduzca la dirección https://.
• Falta un proyecto: los proyectos inactivos no se siguen; con una cuenta de usuario, solo se ven sus proyectos; un nombre escrito en Proyectos seguidos que no corresponde a ningún proyecto se ignora, y Probar la conexión lo indica.
• «Varias tareas abiertas tienen este título»: indique el número (#12).
• Registros: LOG_LEVEL=debug en el contenedor muestra cada lectura.

Límites

• Kanboard se lee cada 1 a 10 minutos (y en cada vencimiento y a medianoche): una tarea cerrada en Kanboard aparece en Gladys en ese plazo. No se usan los webhooks de Kanboard.
• Dos solicitudes por lectura: los proyectos, y luego las tareas abiertas de todos los proyectos seguidos en un único lote JSON-RPC.
• La integración cierra y crea tareas; no las modifica, mueve, asigna ni elimina. Las subtareas no se cuentan.
• Probada con Kanboard v1.2.56, con el token de aplicación y con una cuenta de usuario.
• Gladys no guarda datos de Kanboard aparte de /data/kanboard-state.json (la hora de la última lectura, para que ningún evento se dispare dos veces).
• Sin relación con Kanboard.

Parámetros de configuración

Estos son los parámetros que Kanboard te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Su Kanboard	section	No	Un Kanboard autoalojado (1.2 o posterior). Use el token de API de la aplicación (Settings, API) con el usuario jsonrpc, o su nombre de usuario y su contraseña o token personal.
Dirección	string	Sí	Dirección de Kanboard, con https:// para HTTPS, :puerto si no es el estándar y la subcarpeta si la hay (/kanboard).
Nombre de usuario	string	Sí	jsonrpc para el token de API de la aplicación (todos los proyectos), o su nombre de usuario de Kanboard (sus proyectos).
Token de API o contraseña	secret	Sí	Con jsonrpc: el token de Settings, API. Con un nombre de usuario: su contraseña o token personal (Mi perfil, API).
Opciones	section	No
Proyectos seguidos	string	No	Nombres o números separados por comas. Vacío: todos los proyectos. Un dispositivo por proyecto seguido.
Aceptar certificados autofirmados	boolean	No	Para una dirección https:// con certificado autofirmado. Márquelo solo para su propio servidor.
Intervalo de actualización	select	No	Con qué frecuencia se lee Kanboard. Vencimientos y medianoche se siguen siempre a tiempo.
Idioma de los nombres de funciones	select	No	Nombres de las funciones al añadir un dispositivo y textos enviados a las escenas.

Cómo instalar Kanboard en Gladys

1. En Gladys, abre Integraciones: Kanboard aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-kanboard:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-kanboard.

Kanboard requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas

Kanboard es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂