Saltar al contenido principal

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

Integración Local lists para Gladys Assistant

Listas de la compra y de tareas guardadas en Gladys: panel, escenas, retrasos. Sin nube.

Ver en GitHubTodas las integraciones

Listas de la compra y de tareas guardadas en el propio Gladys: sin cuenta, sin nube, sin otro servidor. Muestre una lista en el panel, añada o marque un elemento con un toque, deje que una escena ponga «bolsas de basura» en la lista de la compra, le recuerde una tarea atrasada o lea la lista en voz alta antes de salir.

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 día a día con un Gladys real. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.

Lo que necesita​

  • Gladys Assistant 5.2.0 o posterior (los formularios de los botones del widget).
  • Nada más: la integración guarda las listas en su propio volumen.

Configuración​

  1. Instale la integración y abra su pestaña Configuración.
  2. Crear una lista: escriba su nombre (p. ej. Compra) y elija su tipo:
    • Lista de la compra: artículos por comprar;
    • Lista de tareas (fechas límite): tareas, cada una con una fecha límite opcional.
  3. Abra la pestaña Descubrimiento y añada la lista: se convierte en un dispositivo de Gladys, que puede renombrar y colocar en una habitación.
  4. Añada el widget Lista local a un panel.

Mostrar las listas da las listas y cuántos elementos quedan en cada una. Eliminar una lista elimina una lista y sus elementos de forma definitiva: escriba su nombre exacto para confirmar. Después elimine también su dispositivo en Gladys. Una lista no se renombra aquí: renombre su dispositivo en Gladys, el widget y las escenas usan ese nombre.

Idioma de los nombres de funciones: el idioma de los nombres que reciben las funciones al añadir una lista, y de los mensajes enviados a las escenas (francés por defecto).

Dispositivos​

Un dispositivo por lista, con:

  • Artículos por comprar (lista de la compra) o Tareas pendientes (lista de tareas): el número de elementos aún sin marcar;
  • Tareas atrasadas (solo listas de tareas): las tareas cuya fecha límite ha pasado.

Estas cifras se guardan en el historial y funcionan en las condiciones de las escenas de Gladys («si hay más de 10 artículos por comprar…»). Una fecha límite sin hora está atrasada al día siguiente; una con hora, al minuto siguiente.

Panel​

El widget Lista local muestra una lista: el número de elementos pendientes, los elementos (diez filas como máximo; las tareas con su fecha límite, las atrasadas en rojo) y cuatro botones:

  • Añadir: un elemento, y para una lista de tareas una fecha límite opcional;
  • Marcar y Desmarcar: elija el elemento en una lista;
  • Quitar hechos: quita los elementos marcados, tras una confirmación.

Ajustes: la lista (vacío: la primera), Mostrar los elementos hechos y Botones que ocultar (p. ej. una tableta de pared que solo muestra la lista).

Escenas​

Desencadenantes​

  • Elemento añadido a una lista local: se ha añadido un elemento desde el widget o una escena, o un elemento marcado vuelve a la lista. Variables: el elemento, la lista, la fecha límite.
  • Elemento marcado en una lista local: variables: el elemento, la lista, el número de elementos pendientes.
  • Lista local terminada: se ha marcado el último elemento pendiente de una lista.
  • Tarea atrasada: una tarea ha superado su fecha límite sin marcarse, una vez por tarea (de nuevo si se desmarca y vuelve a atrasarse). Una tarea que se atrasó mientras Gladys estaba apagado se desencadena en el siguiente arranque.

Cada desencadenante puede limitarse a una lista (vacío: todas las listas).

Acciones​

  • Añadir a una lista local: la lista, el elemento y, para una lista de tareas, una fecha límite opcional: 2026-11-20, 20/11/2026, 20/11/2026 18:30, o +N para dentro de N días (+0 para hoy, +1 08:00 para mañana a las 8). Un elemento que ya está en la lista no se añade dos veces (una tarea toma la nueva fecha límite); un elemento marcado antes vuelve a estar pendiente.
  • Marcar un elemento de lista local: según su texto (se ignoran mayúsculas y acentos), hecho o de nuevo pendiente. Salidas: encontrado, cambiado, número pendiente.
  • Quitar los elementos hechos de una lista local: salida: el número quitado.
  • Leer una lista local: salidas: los elementos pendientes en un texto (Leche, Huevos, Pan), su número, las tareas atrasadas. Para enviar en un mensaje o decir en voz alta.

Ideas de escenas​

  • Cada lunes a las 19:00: «Añadir a una lista local» Sacar la basura, en la lista Casa, fecha límite +0 20:00. Si no está hecho a las 20:00, «Tarea atrasada» se lo recuerda.
  • Una etiqueta NFC en el armario: «Añadir a una lista local» café.
  • Cuando sale de casa (presencia): «Leer una lista local» y envíe su texto a su teléfono.
  • «Tarea atrasada»: un mensaje de Telegram con la tarea y su lista.
  • «Lista local terminada»: una notificación «Todo comprado».

El asistente del chat de Gladys no puede leer ni rellenar las listas por sí mismo: el SDK de las integraciones no ofrece la manera en Gladys 5.3. Las escenas son la manera.

Sus datos​

Todo se guarda en un archivo, lists.json, en el volumen de la integración (/data), con la versión anterior en lists.json.bak. Cada cambio se escribe en un archivo temporal que luego se renombra: un corte de luz nunca deja medio archivo. Si el archivo es ilegible al arrancar, se conserva como lists.json.corrupt y se lee la copia de seguridad en su lugar. Desinstalar la integración elimina su volumen, y las listas con él.

Solución de problemas​

  • La lista no aparece en las escenas ni en los ajustes del widget: añada primero su dispositivo en la pestaña Descubrimiento.
  • «Fecha límite no entendida»: use 2026-11-20, 20/11/2026 18:30 o +3.
  • «No se han podido guardar las listas»: el volumen de la integración está lleno o es de solo lectura; no se ha cambiado nada. Consulte los registros de la integración.
  • Registros: en Gladys, la página de la integración, Registros. Arranque la integración con LOG_LEVEL=debug para más detalle.

Límites​

  • 50 listas, 500 elementos por lista, 200 caracteres por elemento, 40 por nombre de lista.
  • Sin subtareas, sin tareas periódicas, sin compartir fuera de Gladys: las listas viven solo en Gladys. Una tarea periódica es una escena que la añade.
  • El widget muestra diez filas; los formularios ofrecen los primeros cincuenta elementos.
  • Sin importación desde otro servicio ni exportación hacia él.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Sus listassectionNoCree una lista con los botones de abajo y luego añádala en la pestaña Descubrimiento: se convierte en un dispositivo, para mostrar en el panel (widget Lista local) y usar en las escenas. Todo se queda en Gladys.
Idioma de los nombres de funcionesselectNoNombres de las funciones al añadir una lista y textos enviados a las escenas.

Cómo instalar Local lists en Gladys​

  1. En Gladys, abre Integraciones: Local lists 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-local-lists: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-local-lists.

Local lists 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​

Local lists 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.

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 🙂
Última actualización en