Integración domótica Cookidoo, gratuita y de código abierto
Su lista de la compra y plan semanal de Cookidoo (Thermomix) en Gladys: sensores, widgets, escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Lleve su cuenta de Cookidoo — el servicio de recetas de la Thermomix — a Gladys: la lista de la compra y el plan semanal se convierten en sensores, widgets del panel y acciones de escena.
Sin relación con Vorwerk. Cookidoo y Thermomix son marcas de Vorwerk.
Desarrollada sin cuenta de Cookidoo: sus comentarios son bienvenidos. La integración sigue el protocolo de la biblioteca libre cookidoo-api, que utiliza Home Assistant, y se prueba con sus respuestas grabadas, todavía no con una cuenta real.
Presentación
- Lista de la compra: los ingredientes de las recetas añadidas a la lista y los artículos libres que usted ha escrito, marcados o no; el número de artículos por comprar.
- Plan semanal: las recetas previstas hoy (nombres, tiempo total) y el widget «receta del día».
- Suscripción: su tipo (Premium, prueba, gratuita) y su fecha de fin.
- Acciones de escena: añadir un artículo («Añade leche» desde un botón o un comando de voz), marcar o desmarcar un artículo, quitar los artículos marcados.
- Widgets: la lista de la compra con botones para añadir, marcar y quitar, y la receta del día.
Requisitos
- Gladys Assistant 5.2.0 o posterior (los botones de los widgets abren un pequeño formulario, que requiere la 5.2.0).
- Una cuenta de Cookidoo que inicia sesión con un correo y una contraseña, con o sin suscripción.
- Acceso a Internet desde Gladys: la integración habla con los servidores de Cookidoo (nube).
Configuración
Instale la integración desde Integraciones → Instalar desde GitHub y luego indique:
| Campo | Qué indicar |
|---|---|
| Correo, Contraseña | Los de su cuenta de Cookidoo. |
| País de la cuenta | El país elegido al crear la cuenta: determina el sitio de Cookidoo (cookidoo.es, cookidoo.mx, cookidoo.international para los países sin sitio propio...). |
| Idioma de Cookidoo | Idioma de las recetas y los artículos. Automático elige el idioma del país más cercano al campo siguiente (español en cookidoo.es, francés en cookidoo.fr...). |
| Idioma de nombres y estados | Idioma de los nombres de las funciones (fijados una vez, al añadir el dispositivo) y de los textos que muestra. Francés por defecto. |
| Intervalo de actualización | Frecuencia de lectura de la lista y del plan: de 2 a 30 minutos, 5 por defecto. Sus propios cambios desde Gladys se muestran al instante. |
Vaya después a la pestaña Descubrir y añada el dispositivo Cookidoo.
Probar la conexión
El botón Probar la conexión vuelve a iniciar sesión con la contraseña y lo lee todo: la respuesta indica cuántos artículos quedan, la receta del día y la suscripción, o el motivo del fallo. Tras una contraseña rechazada, la integración deja de iniciar sesión por sí sola (volver a intentarlo podría bloquear la cuenta): corrija la contraseña o ejecute esta prueba.
Datos y privacidad
La contraseña se queda en la configuración de Gladys. Los tokens de acceso (válidos 12 horas,
renovados automáticamente) y el identificador de su perfil de Cookidoo se guardan en el volumen de
datos de la integración (/data/cookidoo.json, solo ella puede leerlo). No se envía nada a nadie
más que a Cookidoo, y ninguna contraseña, token ni correo se escribe en los registros.
El dispositivo
Un dispositivo Cookidoo por cuenta, con estas funciones (solo lectura):
| Función | Tipo | Valor |
|---|---|---|
| Artículos por comprar | contador | artículos sin marcar de la lista de la compra |
| Artículos marcados | contador | artículos marcados, todavía en la lista |
| Lista de la compra | texto | los artículos por comprar, separados por comas («Lista vacía» si no hay) |
| Recetas de hoy | texto | las recetas previstas hoy en Cookidoo («Ninguna receta prevista» si no hay) |
| Número de recetas de hoy | contador | cuántas recetas hay previstas hoy |
| Tiempo de las recetas de hoy | duración (min) | tiempo total de las recetas de hoy |
| Suscripción | texto | Premium, Prueba o Gratuita |
| Fin de la suscripción | texto | fecha de fin de la suscripción («Ninguna» sin suscripción) |
| Días de suscripción restantes | duración (días) | días hasta el fin de la suscripción, 0 sin suscripción |
«Hoy» es el día en la zona horaria de Gladys.
Widgets
Añádalos desde el editor del panel (Widgets de integraciones).
Lista de la compra (shopping_list)
El número de artículos por comprar y marcados, los ocho primeros artículos (primero los que faltan por comprar, luego los marcados con una insignia) y cuatro botones:
- Añadir: escriba el nombre de un artículo;
- Marcar / Desmarcar: elija un artículo de la lista;
- Quitar marcados: quita lo que se ha comprado (pide confirmación antes).
Los widgets de Gladys no tienen casillas por decisión de diseño: al pulsar Marcar se abre un pequeño formulario cuya lista contiene los artículos por comprar.
Receta del día (recipe_of_the_day)
Las recetas previstas hoy, con su foto, su tiempo y un enlace para abrirlas en Cookidoo. Si no hay nada previsto hoy, las próximas recetas de la semana, con su día.
Acciones de escena
En una escena, Añadir una acción → Integraciones. El nombre del artículo acepta variables de escena.
Añadir a la lista Cookidoo (add_item)
Añade un artículo libre a la lista de la compra, salvo si un artículo con ese nombre ya está pendiente de comprar; un artículo marcado con ese nombre vuelve a la lista en lugar de duplicarse. Salidas: Artículo añadido (sí/no), Artículos por comprar.
Marcar un artículo Cookidoo (check_item)
Marca el artículo con ese nombre (sin tener en cuenta mayúsculas, acentos ni un artículo inicial: «la leche» encuentra «Leche»). Si varios artículos podrían coincidir, no se marca nada. Salidas: Artículo encontrado, Artículos por comprar.
Desmarcar un artículo Cookidoo (uncheck_item)
Vuelve a poner en la lista un artículo marcado, buscado de la misma manera. Salidas: Artículo encontrado, Artículos por comprar.
Quitar los artículos marcados de Cookidoo (clear_checked_items)
Quita los artículos libres marcados y las recetas con todos sus ingredientes marcados. Cookidoo solo quita un ingrediente junto con su receta: una receta comprada en parte se queda en la lista. Salida: Artículos quitados.
Ejemplos de escenas
- «Añade leche» desde un botón: desencadenante se pulsa un botón → acción Añadir a la lista
Cookidoo con
Leche→ Enviar un mensaje «Leche añadida, {{artículos por comprar}} artículos por comprar». - Recordatorio de la compra: cada sábado a las 9:00, si Artículos por comprar es mayor que 0 → enviar un mensaje con el valor de la función Lista de la compra.
- De vuelta de la compra: cuando llega a casa el sábado por la tarde → Quitar los artículos marcados de Cookidoo.
- A cocinar: cada día a las 18:30, si Número de recetas de hoy es mayor que 0 → mensaje «Esta noche: {{recetas de hoy}} ({{tiempo}} min)».
- Suscripción: cuando Días de suscripción restantes baja de 7 → recordatorio.
Actualización y uso de la API
Gladys no consulta este dispositivo: la integración lee Cookidoo con su propio temporizador, y solo cuando alguien mira (el dispositivo está añadido o se ha mostrado un widget en la última hora). Cada actualización son dos peticiones (lista de la compra y plan semanal); la suscripción se lee cada 6 horas; el token de acceso se renueva dos veces al día. Con los 5 minutos por defecto, son unas 600 peticiones al día. Cookidoo no publica ni cuota ni condiciones para este uso: no ponga el intervalo más bajo de lo necesario. Los valores solo se publican cuando cambian, además de una vez cada 6 horas.
Solución de problemas
- «Cookidoo ha rechazado el inicio de sesión»: compruebe el correo, la contraseña y el país. Si Cookidoo pide un paso (nuevas condiciones de uso, verificación por correo), inicie sesión una vez en la web o en la app y luego ejecute Probar la conexión.
- «Cookidoo ha rechazado la conexión de la integración (protección antirrobots)»: la protección de Cookidoo ha rechazado la petición. La integración nunca la elude: espera 30 minutos y vuelve a intentarlo. Si continúa, indíquelo en el foro.
- «Cookidoo ha respondido con un formato inesperado»: Cookidoo ha cambiado su API; actualice la integración (y abra una incidencia si todavía no hay actualización).
- Artículos o recetas vacíos: compruebe el país y el idioma de Cookidoo.
- Más detalles: configure
LOG_LEVEL=debugen la integración y lea sus registros.
Límites
- API no oficial: Cookidoo puede cambiarla en cualquier momento, y el inicio de sesión puede fallar hasta una actualización.
- Lectura cada pocos minutos: un cambio hecho en la app de Cookidoo aparece tras la siguiente actualización.
- Solo se pueden añadir artículos libres; un ingrediente se quita junto con su receta.
- Ningún control de la propia Thermomix, ni búsqueda de recetas, ni planificación desde Gladys.
- Una sola cuenta por integración.
Parámetros de configuración
Estos son los parámetros que Cookidoo te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cuenta Cookidoo | section | No | La cuenta que utiliza en la app Cookidoo o en la Thermomix. La contraseña se queda en Gladys; los tokens de acceso se guardan en los datos de la integración. Sin relación con Vorwerk. |
| Correo electrónico | string | Sí | Dirección de correo de la cuenta Cookidoo. |
| Contraseña | secret | Sí | |
| País de la cuenta | select | Sí | El país elegido al crear la cuenta: determina el sitio de Cookidoo (cookidoo.fr, cookidoo.de...). |
| Idioma de Cookidoo | select | No | Idioma de las recetas y artículos. Automático: el del país más cercano al idioma de abajo. |
| Idioma de nombres y estados | select | No | Idioma de los nombres de las funciones (fijados al añadir el dispositivo) y de los textos que muestra. |
| Intervalo de actualización | select | No | Frecuencia de lectura de la lista y del plan semanal. Sus propios cambios se muestran al instante. |
Cómo instalar Cookidoo en Gladys
- En Gladys, abre Integraciones: Cookidoo 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-cookidoo: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). - 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-cookidoo.
Cookidoo 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
Cookidoo 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