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

Cámaras y timbres Blink: armado, últimas imágenes, movimiento y timbre en sus escenas.
Esta integración lleva sus cámaras y timbres Blink (Blink Outdoor 4, Blink Mini, Blink Video Doorbell, con o sin Sync Module) a Gladys, a través de la nube de Blink: armado de cada sistema, la última imagen de cada cámara, eventos de movimiento y de timbre en sus escenas, y un widget para el panel.
Sin relación con Blink ni Amazon. Blink es una marca de Amazon.com, Inc. o de sus filiales.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Sigue el protocolo de la biblioteca blinkpy (usada por Home Assistant) y respuestas reales de la nube de Blink publicadas por otros proyectos, pero nunca se ha ejecutado con una cuenta Blink real. Díganos qué funciona y qué no en GitHub.
Requisitos
- Gladys 5.2.0 o posterior.
- Una cuenta Blink (la dirección de correo y la contraseña de la aplicación Blink) con al menos un sistema.
- Acceso a Internet para Gladys: todo pasa por la nube de Blink, no hay acceso local.
- Acceso al buzón o al teléfono de la cuenta: Blink envía un código de verificación en el primer inicio de sesión.
Configuración
Inicio de sesión y código de verificación
- Rellene Correo electrónico y Contraseña y guarde.
- Blink envía un código de verificación por correo o SMS: abra la acción Introducir el código, escriba el código y ejecútela. El mensaje bajo el botón indica cuántos sistemas y cámaras se han encontrado.
- Añada los dispositivos desde la pestaña Descubrimiento.
El código se pide una sola vez: la integración guarda su sesión en /data y la renueva sola. Si un día se rechaza
la sesión (contraseña cambiada, cliente eliminado en la aplicación Blink), vuelve a iniciar sesión sola, como mucho
una vez por hora; cuando Blink pide un código nuevo, la pantalla de configuración lo indica. La acción Iniciar
sesión vuelve a iniciar sesión cuando usted lo pida.
Intervalo de actualización
Frecuencia de lectura de la nube de Blink: 30 segundos, 1 minuto (por defecto), 2 minutos o 5 minutos. Una lectura son dos peticiones a la nube de Blink sea cual sea el número de cámaras, y nunca despierta las cámaras: su batería no se ve afectada. El intervalo es también el retraso de los eventos de movimiento y de timbre. Blink bloquea a los clientes que consultan demasiado: 30 segundos es el mínimo que recomienda blinkpy, y tras una respuesta «demasiadas peticiones» el intervalo se duplica durante un tiempo. El Idioma de los nombres elige los nombres de las funciones de los nuevos dispositivos.
Dispositivos
Sistema
Un dispositivo por sistema Blink (Sync Module, o una Mini o un timbre solos):
- Armado: encendido cuando el sistema está armado. Solo lectura en el dispositivo: arme y desarme desde el widget o una escena (ver más abajo). Es a propósito: un interruptor se expondría a Google Home y Alexa a través de Gladys Plus, y «apaga todo» desarmaría sus cámaras.
- Sync Module en línea: si el Sync Module responde a Blink (solo para un sistema con Sync Module).
Cámara, Mini y timbre
Un dispositivo por cámara:
- Imagen: la última miniatura de la cámara, enviada a Gladys cada vez que Blink tiene una nueva. Cuando Gladys pide una imagen (panel, chat), recibe esta última miniatura: la integración nunca toma una foto por sí misma, porque cada captura despierta la cámara y gasta batería. Solo se toma una imagen nueva cuando usted lo pide (widget o escena).
- Movimiento detectado: encendido durante dos minutos tras un clip de movimiento, apagado si no.
- Detección de movimiento activa: si la cámara graba los movimientos cuando su sistema está armado.
- Temperatura (cámaras con batería): el sensor de la cámara, en °C, a menudo en el exterior: fuera de la media de la habitación.
- Batería baja (cámaras con batería y timbre): Blink solo dice «OK» o «baja», no un porcentaje.
- Señal wifi (cámaras con batería y timbre): de 0 a 5 barras.
- Timbre (Video Doorbell): encendido durante una lectura cuando se pulsa el botón; el panel muestra la hora del último timbrazo.
Widget
El widget Blink muestra la última imagen de cada cámara (con una insignia para un movimiento, una cámara sin conexión o una detección desactivada), el estado del sistema y tres botones:
- Armar y Desarmar (desarmar pide una confirmación); el estado actual lleva una marca;
- Nueva imagen… abre un pequeño formulario para elegir la cámara, que toma una foto nueva.
Con varios sistemas, elija el sistema en los ajustes del widget (un sistema o una de sus cámaras); sin elección, el widget muestra todos los sistemas, sin los botones de armado.
Disparadores de escena
- Blink: movimiento detectado: una cámara ha grabado un clip de movimiento. Filtro: una cámara (vacío: cualquiera). Variables: el nombre de la cámara y el del sistema.
- Blink: timbre pulsado: alguien ha pulsado el botón de un Video Doorbell. Filtro: un timbre (vacío: cualquiera).
Ambos llegan con el retraso del intervalo de actualización, más el tiempo que Blink tarda en subir el clip (a menudo de 10 a 30 segundos). Blink solo graba si el sistema está armado y la detección de la cámara activada.
Acciones de escena
- Blink: armar o desarmar: arma o desarma un sistema (elija el sistema o una de sus cámaras). Salida: armado.
- Blink: detección de movimiento: activa o desactiva la detección de una cámara. Salida: detección activada.
- Blink: tomar una nueva imagen: despierta la cámara para una imagen nueva (gasta batería) y la publica en el dispositivo de la cámara. Como mucho una por cámara y por minuto. Salida: imagen tomada.
Ejemplos de escenas
- Seguir la alarma de Gladys: disparador «alarma armada» → Blink: armar o desarmar (armar); disparador «alarma desarmada» → desarmar.
- ¿Quién llama?: Blink: timbre pulsado → Blink: tomar una nueva imagen del timbre → la acción de Gladys «enviar una imagen de cámara» a su teléfono.
- Luz del jardín por la noche: Blink: movimiento detectado (cámara del jardín) → condición «es de noche» → encender la luz del jardín.
Solución de problemas
- «Blink le ha enviado un código de verificación»: introdúzcalo con Introducir el código. Un código introducido más de 15 minutos después se rechaza: ejecute Iniciar sesión para recibir uno nuevo.
- «correo o contraseña rechazados por Blink»: compruébelos en la aplicación Blink y vuelva a guardar la configuración.
- «la página de inicio de sesión de Blink ha cambiado»: Blink ha cambiado su inicio de sesión; hace falta actualizar la integración (abra una incidencia).
- Ningún evento de movimiento: el sistema debe estar armado y la detección de la cámara activada; el evento llega en la siguiente lectura.
- Registros detallados: configure
LOG_LEVEL=debugen la integración. Los registros nunca muestran la contraseña, los tokens ni los códigos.
Límites
- Solo nube: sin Internet no funciona nada; Blink no tiene API local.
- Sin vídeo en directo ni descarga de clips: solo miniaturas.
- Blink no envía avisos a terceros: el movimiento y el timbre se ven en la siguiente lectura.
- Una pulsación del timbre se reconoce por el clip que graba Blink; si el timbre no graba nada al pulsarlo (ajuste de la aplicación Blink), no se ve.
- Blink no publica su API: un cambio por su parte puede romper la integración hasta que se actualice.
Privacidad y datos
La integración guarda en /data (legible solo por su propietario) el identificador de este cliente ante Blink y
los tokens de sesión, nunca la contraseña ni la dirección de correo. Las imágenes quedan entre Blink, la
integración y su Gladys.
Parámetros de configuración
Estos son los parámetros que Blink te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta Blink | section | No | La dirección de correo y la contraseña de la aplicación Blink. Al guardar, Blink envía un código de verificación por correo o SMS: introdúzcalo con la acción «Introducir el código» de abajo. Sin relación con Blink ni Amazon. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | Guardada por Gladys, solo se usa para iniciar sesión en Blink. |
| Intervalo de actualización | select | No | Frecuencia de lectura de la nube de Blink: es también el retraso de los eventos de movimiento y timbre. La lectura no despierta las cámaras. |
| Idioma de los nombres | select | No | Idioma de los nombres de funciones de los nuevos dispositivos y de los mensajes de las acciones de escena. |
Cómo instalar Blink en Gladys
- En Gladys, abre Integraciones: Blink 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-blink: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-blink.
Blink 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
Blink 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