Integración domótica Donetick, gratuita y de código abierto
Tareas de Donetick: del día y atrasadas, marcadas como hechas desde el panel o una escena.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Lleve las tareas domésticas de su Donetick a Gladys: lo que queda por hacer hoy, lo que está atrasado, quién hace qué. Un toque en el panel marca una tarea como hecha, una escena avisa a quien va con retraso y otra reacciona cuando se saca la basura.
Sus comentarios son bienvenidos. Esta integración se ha probado con un servidor Donetick real (imagen Docker
donetick/donetick, octubre de 2026), pero todavía no en el día a día. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Un Donetick autoalojado, accesible desde Gladys (la imagen Docker escucha en el puerto 2021).
- Un token de acceso de un usuario de Donetick. En Donetick: Settings
→ Access tokens → Generate new token, póngale un nombre (
Gladys) y copie el token, que empieza pordt_: Donetick solo lo muestra una vez.
La integración ve las tareas que ve este usuario (todo el círculo, salvo las tareas privadas de los demás miembros) y marca las tareas como hechas en su nombre. Elija un usuario administrador o gestor del círculo si la acción de escena o el widget deben completar tareas asignadas a otra persona.
Instalación
- En Gladys, Integraciones → instale Donetick.
- En la pantalla de Configuración, rellene:
- Dirección: la dirección de Donetick, por ejemplo
http://192.168.1.20:2021, ohttps://tareas.example.orgdetrás de un proxy inverso (se conserva un prefijo de ruta como/donetick); - Token de acceso: el token
dt_….
- Dirección: la dirección de Donetick, por ejemplo
- Opciones:
- Un dispositivo por miembro (activado por defecto): además del dispositivo del hogar, un dispositivo por miembro del círculo, para las tareas que tiene asignadas;
- Aceptar certificados autofirmados: para una dirección
https://con un certificado autofirmado, solo en su propio servidor; - Intervalo de actualización: de 1 a 10 minutos (2 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.
- Guarde y pulse Probar la conexión: la integración lee Donetick e indica el número de tareas activas y de miembros.
- En la pestaña Descubrimiento, añada los dispositivos que desee.
Dispositivos
Donetick (el hogar) y, con la opción, Donetick miembro para cada miembro del círculo. Cada uno tiene cuatro funciones:
| Función | Lo que indica |
|---|---|
Tareas para hoy | tareas activas que vencen antes de medianoche, atrasadas incluidas: lo que queda para esta noche |
Tareas atrasadas | tareas activas cuyo vencimiento ha pasado |
Tareas hechas hoy | realizaciones registradas hoy (las tareas saltadas no cuentan) |
Próxima tarea | el nombre de la tarea con el vencimiento más próximo, atrasadas primero; Ninguna si no hay nada |
En un dispositivo de miembro, los contadores solo toman las tareas que tiene
asignadas, y Tareas hechas hoy las que ha hecho él. Las tareas sin
vencimiento no entran en ningún contador. «Hoy» es el día en la zona horaria
de Gladys.
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 y la persona asignada, y un botón para cada una de las cuatro más urgentes: un toque marca la tarea como hecha. Elija un dispositivo de miembro en la configuración del widget para ver solo sus tareas; déjelo vacío para todo el hogar. Cuando no queda nada, el widget lo indica y muestra la próxima tarea.
Los contadores también pueden ir al panel como cualquier función de dispositivo.
Escenas
Disparadores
- Tarea de Donetick atrasada: una tarea ha superado su vencimiento sin hacerse, una vez por vencimiento (una tarea que sigue atrasada al día siguiente no vuelve a disparar; su siguiente ocurrencia, sí). Filtros: el miembro asignado (un dispositivo de miembro), el nombre de la tarea. Información transmitida a las acciones: la tarea, su número, a quién está asignada, el vencimiento.
- Tarea de Donetick hecha: una tarea se ha marcado como hecha, en Donetick o desde Gladys. Filtros: quién la ha hecho (un dispositivo de miembro), el nombre de la tarea. Información: la tarea, su número, quién la ha hecho y si se hizo a tiempo, y si se marcó como hecha desde Gladys (una escena que marca tareas como hechas puede así ignorar las suyas, sin entrar nunca en bucle).
Lo que ya está atrasado o hecho en el primer arranque de la integración es conocido, no novedad: no se dispara nada por ello. Un reinicio no anuncia dos veces una tarea, y una tarea que se atrasó mientras la integración estaba detenida se anuncia al volver a arrancar.
Acciones
- Marcar una tarea de Donetick como hecha: marca una tarea como hecha
ahora, en nombre del usuario del token de acceso. Indique el nombre de
la tarea tal como está escrito en Donetick (sin distinguir mayúsculas ni
acentos) o su número (
#12, el número en la dirección de la página de la tarea en Donetick). El campo acepta variables de escena. Resultados para los pasos siguientes: la tarea, su número, si espera una aprobación, su próximo vencimiento. Una tarea que requiere aprobación se envía para su aprobación, como en Donetick.
Ideas de escenas
- A las 20 h, si
Tareas para hoyde un miembro es mayor que 0, enviarle un mensaje. - Una etiqueta NFC o un botón junto a los cubos de basura lanza Marcar una
tarea de Donetick como hecha con
Sacar la basura. - Tarea de Donetick atrasada con el filtro de miembro: avisar a ese miembro por Telegram, con la tarea en el mensaje.
- Tarea de Donetick hecha para
Regar las plantas: cerrar el grifo del jardín.
Solución de problemas
- «Donetick no responde»: compruebe la dirección y el puerto desde el
equipo de Gladys (
http://<dirección>:2021abre Donetick en un navegador). - «Token de API rechazado»: el token se ha borrado o se ha copiado mal. Cree uno nuevo en Donetick (Settings → Access tokens).
- «No hay ninguna API de Donetick en esta dirección»: la dirección responde, pero no con la API de Donetick: compruebe el puerto o el prefijo de ruta detrás de un proxy inverso.
- «La dirección redirige»: introduzca la dirección
https://. - «El usuario del token no está asignado a esta tarea»: Donetick solo deja completar una tarea a las personas asignadas (o a un administrador o gestor del círculo). Use el token de un administrador o asigne la tarea al usuario del token.
- «Aún no está en su periodo de realización»: la tarea tiene una ventana de realización en Donetick y no puede hacerse tan pronto.
- Falta una tarea: las tareas archivadas y las tareas privadas de otros miembros no son visibles para el usuario del token.
- Registros:
LOG_LEVEL=debugen el contenedor muestra cada lectura.
Limitaciones
- Donetick se lee cada 1 a 10 minutos (y en cada vencimiento y a medianoche): una tarea hecha en Donetick aparece en Gladys en ese plazo.
- La integración lee las tareas y las marca como hechas, nada más: no crea, modifica, salta ni asigna tareas.
- Probada con el Donetick autoalojado de octubre de 2026. La nube donetick.com debería aceptar el mismo token en la dirección de su API, pero no se ha probado.
- Gladys no guarda ningún dato de Donetick salvo
/data/donetick-state.json(las tareas ya anunciadas a las escenas). - Donetick tiene su propio límite de solicitudes (300 por minuto por defecto): la integración hace dos o tres solicitudes por lectura.
- Una tarea pendiente de aprobación aparece como Por aprobar en el widget, sin botón. Un botón del widget rechaza una tarea ya hecha entretanto.
- Una tarea única hecha mientras la integración estaba detenida se anuncia
por su número (
#12), ya que su nombre ha salido de la lista de Donetick. - Sin relación con Donetick.
Parámetros de configuración
Estos son los parámetros que Donetick te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su Donetick | section | No | Un Donetick autoalojado. En Donetick, cree un token de acceso: Settings, Access tokens. Las tareas se marcan como hechas en nombre del usuario del token. |
| Dirección | string | Sí | Dirección de Donetick, con https:// para HTTPS y :puerto si no es el estándar (2021 para la imagen Docker). |
| Token de acceso | secret | Sí | Creado en Donetick: Settings, Access tokens. Empieza por dt_. |
| Opciones | section | No | |
| Un dispositivo por miembro | boolean | No | Además del dispositivo del hogar, un dispositivo por miembro del círculo, para las tareas que tiene asignadas. |
| 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 Donetick. Los vencimientos y la 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 Donetick en Gladys
- En Gladys, abre Integraciones: Donetick aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-donetick: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). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-donetick.
Donetick 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
Donetick 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