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

Sus listas de la compra compartidas de OurGroceries en Gladys: artículos, escenas y widget.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.2.0
• ★ 0

Ver en GitHubTodas las integraciones

Sus listas de la compra compartidas de OurGroceries en Gladys: los artículos que quedan por comprar en cada lista, un widget para el panel con el que añadir y tachar artículos, y tarjetas de escena para poner «leche» en la lista al pulsar un botón.

Esta integración no está afiliada a OurGroceries. Se ha desarrollado sin una cuenta de OurGroceries con la que probarla: sus comentarios son bienvenidos, en el foro de Gladys o en las issues de GitHub.

Qué hace

• Un dispositivo de Gladys por cada lista de la compra que elija, con el número de artículos por comprar, el número de artículos tachados y la propia lista como texto.
• Un widget Lista de la compra para el panel: los artículos por comprar, con botones para añadir, tachar y vaciar.
• Un disparador de escena, Artículo añadido a una lista de la compra, y tres acciones de escena: Añadir a una lista de la compra, Tachar un artículo y Quitar los artículos tachados.
• Los cambios hechos en la aplicación OurGroceries llegan a Gladys en la siguiente actualización (cada 5 minutos por defecto).

Requisitos

• Gladys 5.2.0 o posterior.
• Una cuenta de OurGroceries con correo electrónico y contraseña. Una cuenta abierta con «Iniciar sesión con Google» o «con Apple» no tiene contraseña: defina una primero en el sitio web de OurGroceries.
• Acceso a Internet desde Gladys: la integración se comunica con los servidores de OurGroceries.

Configuración

1. En Gladys, abra Integraciones, luego Instalar desde GitHub, e instale guim31/gladys-ourgroceries (o instálela desde la tienda).
2. En la pestaña Configuración, introduzca el correo electrónico y la contraseña de su cuenta de OurGroceries y guarde.
3. Si lo desea, elija con qué frecuencia se leen las listas (Actualizar cada, 5 minutos por defecto) y el Idioma de los textos (francés por defecto): da nombre a las funciones al añadir una lista y redacta el texto de la lista y los mensajes.
4. Pulse Probar la conexión y actualizar: el mensaje bajo el botón indica cuántas listas de la compra tiene la cuenta.
5. Abra la pestaña Descubrir: allí aparece cada lista de la compra de la cuenta. Añada a Gladys las que desee. Las recetas no son listas de la compra y se dejan fuera.

Dispositivos

Cada lista de la compra añadida se convierte en un dispositivo con el nombre de la lista y tres funciones de solo lectura:

Función	Qué contiene
Artículos por comprar	Cuántos artículos no están tachados
Artículos tachados	Cuántos artículos están tachados y siguen en la lista
Lista	Los nombres de los artículos por comprar, separados por comas (255 caracteres como máximo)

Si cambia el nombre de una lista en OurGroceries, conserva su dispositivo: Gladys reconoce la lista por su identificador de OurGroceries, no por su nombre. Una lista creada más tarde en la aplicación aparece en la pestaña Descubrir en la siguiente actualización.

Widget del panel

Añada el widget Lista de la compra a un panel y elija la lista en sus ajustes. Muestra el nombre de la lista, el número de artículos por comprar (en directo), los 8 primeros artículos y cuántos quedan, y tres botones:

• Añadir abre un campo para escribir un artículo;
• Tachar abre la lista de artículos por comprar: elija uno;
• Quitar tachados elimina los artículos tachados, tras una confirmación.

Los widgets de Gladys no tienen casillas: se tacha mediante la lista del botón Tachar. Añadir un artículo que ya está en la lista no cambia nada; añadir un artículo tachado lo devuelve a la lista, como hace la aplicación.

Disparador de escena

Artículo añadido a una lista de la compra inicia una escena cuando alguien añade un artículo en OurGroceries. Elija una lista o deje el campo vacío para todas. La escena puede usar el Artículo y el Nombre de la lista en sus mensajes.

El disparador se activa en la actualización que sigue a la adición (hasta 5 minutos después por defecto). Los artículos añadidos por la propia Gladys (una escena, el widget) no lo activan: una escena no puede llamarse a sí misma en bucle. Un artículo tachado y luego recuperado cuenta como añadido.

Acciones de escena

• Añadir a una lista de la compra: pone un artículo en la lista elegida. Si ya está, nada cambia. Si está tachado, vuelve a la lista. Devuelve Artículo añadido (no, si ya estaba) y Artículo tal como en la lista.
• Tachar un artículo: tacha el artículo con este nombre. Mayúsculas, acentos y una cantidad entre paréntesis no cuentan: «leche» tacha «Leche (2)». Devuelve Artículo encontrado y tachado.
• Quitar los artículos tachados: elimina los artículos tachados de la lista. Devuelve Artículos eliminados.

Los campos de texto aceptan información de la escena, como el artículo del disparador.

Ejemplos de escenas

• Botón «no queda leche»: disparador «se pulsa un botón» (un botón Zigbee en la nevera), acción Añadir a una lista de la compra con el artículo «Leche».
• Avisarme de lo que se ha añadido: disparador Artículo añadido a una lista de la compra, acción «enviar un mensaje» con el Artículo y el Nombre de la lista.
• De vuelta de la compra: disparador «el usuario llega a casa», condición Artículos tachados mayor que 0, acción Quitar los artículos tachados.

Actualización y límites del servicio

OurGroceries no publica ni API ni cuota. Como la integración de Home Assistant, esta integración usa las peticiones del sitio web oficial, con moderación:

• una petición por actualización lee el resumen de la cuenta; los artículos de una lista solo se vuelven a leer si la lista ha cambiado;
• solo se leen las listas añadidas a Gladys;
• el periodo es de 5 minutos por defecto (2 minutos como mínimo, 30 como máximo); el botón de prueba, el widget y las acciones de escena leen y escriben al momento;
• tras un rechazo de las credenciales no se hace ningún otro intento hasta que cambie la configuración o pulse Probar la conexión y actualizar: reintentar una contraseña incorrecta puede bloquear una cuenta.

Úsela respetando las condiciones de OurGroceries.

Datos y privacidad

La contraseña la guarda Gladys, como cualquier campo secreto. La integración solo conserva la cookie de sesión de OurGroceries y el identificador de equipo en su propio volumen (/data/session.json), para no iniciar sesión de nuevo en cada reinicio. Ni la contraseña, ni el correo, ni la cookie aparecen nunca en los registros.

Solución de problemas

• «OurGroceries ha rechazado el correo o la contraseña»: compruébelos en el sitio web de OurGroceries y vuelva a guardar la configuración.
• «OurGroceries no está disponible»: la integración vuelve a intentarlo en cada actualización e indica en los registros cuándo responde de nuevo el servicio.
• Un cambio hecho en la aplicación aún no está en Gladys: espere a la siguiente actualización o pulse Probar la conexión y actualizar.
• Los registros de la integración: abra la integración en Gladys y después sus registros. Para ver cada petición, ponga la variable LOG_LEVEL del contenedor en debug.

Limitaciones

• Desarrollada sin cuenta de OurGroceries: las peticiones siguen la biblioteca Python ourgroceries que usa Home Assistant. Si OurGroceries cambia su sitio web, la integración puede dejar de funcionar hasta que se actualice.
• Los cambios llegan a Gladys en la siguiente actualización, no al instante.
• Las categorías, notas, cantidades, recetas y la lista principal no se gestionan. Un artículo se añade sin categoría: OurGroceries lo clasifica como en la aplicación.
• El botón Tachar del widget ofrece los 50 primeros artículos por comprar.
• Los nombres de las funciones se fijan en el idioma de la configuración al añadir una lista; cambiar de idioma después no cambia ningún nombre.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Su cuenta de OurGroceries	section	No	Introduzca el correo electrónico y la contraseña de su cuenta de OurGroceries. Después abra la pestaña Descubrir y añada a Gladys las listas de la compra que desee. Esta integración no está afiliada a OurGroceries.
Correo electrónico	string	Sí
Contraseña	secret	Sí	Lo guarda Gladys. El contenedor solo conserva la cookie de sesión en su volumen.
Actualizar cada	select	No	Frecuencia de lectura de las listas. OurGroceries no tiene API pública: sea moderado.
Idioma de los textos	select	No	Nombres de las funciones (fijados al añadir una lista), texto de la lista y mensajes.

Cómo instalar OurGroceries en Gladys

1. En Gladys, abre Integraciones: OurGroceries 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-ourgroceries:1.0.1), 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-ourgroceries.

OurGroceries 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

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