Integración domótica Maintenance reminders, gratuita y de código abierto
Mantenimiento periódico (caldera, filtros, chimenea…): días restantes, avisos, botón Hecho.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.2.0
- ★ 0
Los trabajos periódicos de la casa, guardados en el propio Gladys: la revisión de la caldera cada año, los filtros de ventilación cada seis meses, el deshollinado, la ITV, la descalcificación, las pilas de los detectores de humo… Cada tarea cuenta los días restantes, le avisa antes del vencimiento, indica cuándo está atrasada, y un toque en Hecho vuelve a empezar el contador. Sin cuenta, sin nube.
Sus comentarios son bienvenidos. Esta integración se ha probado con el Gladys de prueba del SDK y en su imagen Docker, todavía no en el uso diario con un Gladys real. Si algo no funciona como se describe, díganoslo en el foro de Gladys o en las issues.
Lo que necesita
- Gladys Assistant 5.2.0 o posterior (el formulario del botón del widget).
- Nada más: la integración guarda las tareas en su propio volumen.
Puesta en marcha
- Instale la integración y abra su pestaña Configuración.
- Crear o modificar una tarea:
- elija una tarea propuesta (revisión de la caldera 1 año, deshollinado 1 año, ITV 2 años, filtros de ventilación 6 meses, filtro de la aspiradora 3 meses, descalcificación 2 meses, pilas de los detectores de humo 1 año, aire acondicionado, filtro de la campana, filtro de agua, canalones, fosa séptica, extintor): el nombre, el periodo y el aviso previo se rellenan por usted;
- o escriba un nombre y un periodo: Cada (un número) y una Unidad (días, semanas, meses, años), diez años como máximo;
- Última vez hecha:
2026-03-14,14/03/2026, o-30para hace 30 días; vacío, hoy; - Aviso previo (días): cuántos días antes del vencimiento la tarea está «próxima a vencer» (vacío: el de la tarea propuesta, si no 7).
- Abra la pestaña Descubrimiento y añada la tarea: se convierte en un dispositivo de Gladys, que puede renombrar y colocar en una habitación.
- Añada el widget Próximos mantenimientos a un panel.
La misma acción modifica una tarea: indique su nombre y solo lo que cambia (el periodo, el aviso o una última fecha corregida). Marcar una tarea como hecha registra que se hizo, hoy o en la fecha indicada. Mostrar las tareas da cada tarea y su próximo vencimiento. Eliminar una tarea la elimina con su historial, de forma definitiva: escriba su nombre exacto para confirmar y luego elimine también su dispositivo en Gladys.
Idioma de los nombres de funciones: el idioma de los nombres que reciben las funciones al añadir una tarea, de las fechas que muestran y de los textos enviados a las escenas (francés por defecto).
El vencimiento de una tarea mensual o anual conserva el día del mes, o toma el último día de un mes más corto: hecha el 31 de enero, una tarea mensual vence el 28 de febrero (el 29 en un año bisiesto). Los días cambian a medianoche, en la zona horaria de Gladys.
Dispositivos
Un dispositivo por tarea, con seis funciones:
| Función | Valor |
|---|---|
| Días restantes | días hasta el vencimiento, negativo una vez atrasada |
| Periodo restante | la parte del periodo que queda, 100 % el día en que se hace, 0 al vencer |
| Próximo a vencer | 1 dentro del aviso previo, hasta el vencimiento |
| Atrasado | 1 desde el día siguiente al vencimiento hasta que se hace |
| Última vez | la última fecha en que se hizo |
| Próximo vencimiento | el vencimiento |
Los nombres son los del idioma configurado (aquí, español). Gladys no ofrece eventos de calendario a una integración de dispositivos: los vencimientos son funciones, el widget y las escenas, no entradas del calendario de Gladys.
Panel
El widget Próximos mantenimientos muestra cuántas tareas están próximas a vencer o atrasadas, y luego las próximas tareas por vencimiento: las atrasadas en rojo («8 d de retraso»), las próximas en naranja («en 11 d»), las demás con su fecha. Hecho abre un formulario: elija la tarea y la fecha en que se hizo (vacío: hoy).
Ajustes: las tareas mostradas (todas, o solo las próximas o atrasadas), el número de filas (3 a 10) y los elementos que ocultar (el número, el botón Hecho).
Escenas
Desencadenantes
- Mantenimiento próximo: una tarea entra en su periodo de aviso (p. ej. 30 días antes de la revisión de la caldera). Una vez por vencimiento.
- Mantenimiento atrasado: una tarea ha superado su vencimiento sin marcarse como hecha. Una vez por vencimiento.
Ambos pueden limitarse a una tarea (vacío: todas) y dan el nombre de la
tarea, su vencimiento (AAAA-MM-DD) y sus días restantes.
Acciones
- Marcar un mantenimiento como hecho: el contador de la tarea vuelve a
empezar, desde hoy o desde una fecha (
2026-03-14,14/03/2026,-2). Da la última fecha, el próximo vencimiento y los días restantes. - Leer las tareas de mantenimiento: lo próximo a vencer o atrasado en un texto («Filtros de ventilación (8 d de retraso), Revisión de la caldera (en 11 d)»), o todas las tareas, con el número de tareas atrasadas y próximas y la próxima tarea.
Ideas de escenas
- «Mantenimiento próximo»: un mensaje de Telegram «Pedir cita para la caldera antes del {{due}}».
- Cada lunes a las 8: Leer las tareas de mantenimiento, y luego un mensaje con el texto cuando algo vence.
- Una etiqueta NFC en la aspiradora: Marcar un mantenimiento como hecho para su filtro.
Sus datos
Todo se guarda en un único archivo, tasks.json, en el volumen de la
integración (/data), con la versión anterior como tasks.json.bak. Cada
cambio se escribe en un archivo temporal y luego se renombra: un corte de
luz nunca deja un archivo a medias. Si el archivo no se puede leer al
arrancar, se guarda como tasks.json.corrupt y se lee la copia de
seguridad. Se conservan las veinte últimas fechas de cada tarea.
Desinstalar la integración elimina su volumen, y las tareas con él.
Solución de problemas
- La tarea no aparece en las escenas ni en los ajustes del widget: añada primero su dispositivo en la pestaña Descubrimiento.
- «Fecha no entendida»: use
2026-03-14,14/03/2026o-7. - «Esta fecha está en el futuro»: indique el día en que se hizo.
- «No se han podido guardar las tareas»: el volumen de la integración está lleno o en solo lectura; no se ha cambiado nada. Consulte los registros de la integración.
- Registros: en Gladys, la página de la integración, Logs. Arranque la
integración con
LOG_LEVEL=debugpara más detalle.
Límites
- 100 tareas, 40 caracteres por nombre, un periodo de diez años como máximo, un aviso previo de 365 días como máximo. Los días restantes mostrados se limitan a ±3660.
- Una fecha por tarea: sin hora, sin subtareas, sin recordatorio repetido cada día (una escena sobre «Atrasado» puede hacerlo).
- Sin entradas en el calendario de Gladys (ver Dispositivos), sin importación desde otro servicio.
Parámetros de configuración
Estos son los parámetros que Maintenance reminders te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus tareas de mantenimiento | section | No | Cree una tarea con los botones de abajo (una propuesta o la suya) y luego añádala en la pestaña Descubrimiento: se convierte en un dispositivo con sus días restantes, para el panel (widget Próximos mantenimientos) y las escenas. Todo se queda en Gladys. |
| Idioma de los nombres de funciones | select | No | Nombres de las funciones al añadir una tarea, fechas y textos enviados a las escenas. |
Cómo instalar Maintenance reminders en Gladys
- En Gladys, abre Integraciones: Maintenance reminders 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-entretien: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-entretien.
Maintenance reminders requiere Gladys >=5.2.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
Maintenance reminders 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