Integración domótica Scrypted, gratuita y de código abierto
Cámaras, timbres, detección de movimiento y objetos, enchufes y cerraduras de Scrypted.
Publicado por prohand
- Dispositivos
- Versión 1.0.2
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración conecta Gladys con Scrypted, la plataforma de vídeo para el hogar que reúne sus cámaras (Reolink, Hikvision, Amcrest, UniFi, ONVIF, Ring, Nest…), sus timbres y sus detecciones. Scrypted hace el trabajo de vídeo; Gladys recibe los dispositivos, las imágenes y los eventos, y los convierte en escenas y paneles.
Lo que obtiene
| En Scrypted | En Gladys |
|---|---|
| Cámara | Cámara (imágenes) |
| Sensor de movimiento (cámara o sensor) | Sensor de movimiento + disparador «detecta movimiento» |
| Botón del timbre | Timbre + disparador «se pulsa un timbre» |
| Detección de objetos (NVR, plugins de detección) | Disparador «detecta un objeto» |
| Luz (encendido, brillo) | Luz |
| Interruptor, enchufe | Interruptor |
| Sirena | Sirena |
| Cerradura | Cerradura |
| Sensor de puerta / ventana | Sensor de apertura |
| Termómetro, higrómetro | Sensor de temperatura, sensor de humedad |
| Batería | Nivel de batería |
Scrypted envía cada cambio en el momento en que ocurre: no se consulta nada en bucle.
Antes de empezar
Necesita un servidor Scrypted en marcha, con sus cámaras ya funcionando en él.
- En la consola de Scrypted, abra Settings → Users y cree un usuario para Gladys. Un administrador ve todos los dispositivos; un usuario normal solo ve los que usted le asigna, que es lo que necesita si algunas cámaras deben quedar fuera de Gladys.
- Obtenga un token de acceso para ese usuario en lugar de usar su
contraseña: en un ordenador de su red, ejecute
npx scrypted login <dirección de Scrypted>e inicie sesión con ese usuario. El token se guarda en el archivologin.jsonde la carpeta.scryptedde su carpeta personal (el valortoken). Un token se puede revocar sin cambiar la contraseña.
Configuración
Abra la integración en Gladys y luego Configuración.
| Campo | Qué poner |
|---|---|
| Dirección local | La dirección del servidor en su red, con su puerto: https://192.168.1.20:10443/ |
| Dirección de Scrypted Cloud | La dirección que el plugin Scrypted Cloud da a su servidor (o su dominio). Puede quedar vacía |
| Nombre de usuario | El usuario de Scrypted creado para Gladys |
| Contraseña o token de acceso | Su token de acceso (o su contraseña) |
| Intervalo de imágenes de cámara (s) | Cada cuánto envía cada cámara una imagen nueva. 60 por defecto, mínimo 10, 0 = solo en eventos |
| Imagen en cada evento | Una imagen nueva cuando una cámara ve movimiento, un objeto o una pulsación del timbre |
| Pausa entre detecciones (s) | Cuánto espera una cámara antes de volver a lanzar «detecta un objeto» para el mismo tipo de objeto |
Pulse luego Probar la conexión: la respuesta indica qué dirección respondió, la versión de Scrypted y cuántos dispositivos y cámaras se encontraron.
Local o nube
El manifiesto declara las dos conexiones, así que Gladys muestra un interruptor Preferir la conexión local:
- activado (por defecto): se prueba primero la dirección local, Scrypted Cloud toma el relevo cuando no responde;
- desactivado: primero Scrypted Cloud, la dirección local como respaldo.
Indique una dirección o las dos. Cuando Gladys funciona con la dirección de respaldo, cada dispositivo de Scrypted muestra su insignia de transporte con un punto naranja, y la información emergente explica por qué. La dirección preferida se vuelve a probar cada 10 minutos y se recupera en cuanto responde.
Scrypted usa un certificado autofirmado en https://<ip>:10443: la
integración lo acepta, como hacen las aplicaciones de Scrypted. El simple
http://<ip>:11080 también funciona en una red de confianza.
Añadir los dispositivos
Una vez conectado, abra la pestaña Descubrir de la integración: cada dispositivo de Scrypted que Gladys sabe usar está ahí, con su nombre de Scrypted. Añada los que quiera y colóquelos en su habitación.
Una cámara añadida o renombrada más tarde en Scrypted aparece sola tras unos segundos. El botón Sincronizar los dispositivos lo hace bajo demanda.
Imágenes de las cámaras
Cada cámara envía una imagen:
- cada Intervalo de imágenes de cámara segundos;
- en cada movimiento, objeto o pulsación del timbre (si Imagen en cada evento está activado);
- cuando el panel de Gladys o un mensaje de chat la pide;
- cuando una escena ejecuta Tomar una imagen con una cámara Scrypted.
Gladys acepta imágenes de hasta 150 KB: se piden más pequeñas a Scrypted hasta que caben. Una cámara nunca envía más de 12 imágenes por minuto.
Escenas
Disparadores
- Una cámara Scrypted detecta movimiento: cuando una cámara o un sensor pasa de reposo a movimiento. Filtro: el dispositivo. Variable: el nombre del dispositivo.
- Se pulsa un timbre de Scrypted: el botón del timbre. Filtro: el timbre. Variable: el nombre del dispositivo.
- Una cámara Scrypted detecta un objeto: lo que reconoce la detección de objetos de Scrypted (Scrypted NVR, OpenVINO, CoreML, ONNX…). Filtros: la cámara y el tipo de objeto (persona, vehículo, animal, paquete, cara, matrícula, otro objeto). Variables: el nombre del dispositivo, el tipo de objeto, el nombre (cara o matrícula reconocidas, si lo hay) y la confianza en porcentaje.
Una persona que pasa delante de una cámara da un evento, no uno por imagen: la misma cámara espera la Pausa entre detecciones antes de volver a lanzarlo para el mismo tipo de objeto.
Acciones
- Tomar una imagen con una cámara Scrypted: se envía una imagen nueva a Gladys, lista para la acción «enviar la imagen de una cámara». Salida: si se tomó una imagen.
- Sincronizar los dispositivos de Scrypted: vuelve a leer la lista de dispositivos de Scrypted. Salida: el número de dispositivos encontrados.
Ejemplo: «Cuando llamen al timbre, tomar una imagen con la cámara del timbre y enviármela en un mensaje.»
Widgets del panel
- Scrypted: la conexión (local, nube, respaldo o inaccesible), la versión del servidor, el número de dispositivos y cámaras, los últimos eventos vistos y dos botones: Sincronizar y Todas las imágenes.
- Cámara Scrypted: elija una cámara en los ajustes del widget. Muestra su última imagen, su estado de movimiento en directo y un botón Tomar una imagen.
Solución de problemas
| Lo que ve | Qué hacer |
|---|---|
| «Indique la dirección de Scrypted…» | Se necesitan una dirección, el nombre de usuario y la contraseña o el token |
| «Scrypted no responde (… statusCode 401)» | Nombre de usuario, contraseña o token incorrectos. Cree un token nuevo con npx scrypted login |
| «Scrypted no responde (ECONNREFUSED)» | Dirección o puerto incorrectos, o Scrypted detenido. Abra la misma dirección en un navegador de su red |
| «Scrypted no responde (no answer after 20 s)» | La dirección responde demasiado despacio o no responde: cortafuegos, VPN, IP incorrecta |
| Falta una cámara | El usuario de Scrypted no tiene acceso a ella, o no da imagen en Scrypted (plugin Snapshot) |
| Ningún evento «detecta un objeto» | La detección de objetos debe estar activada para esa cámara en Scrypted (Scrypted NVR o un plugin de detección) |
| Punto naranja en la insignia de transporte | Gladys funciona con la dirección de respaldo: la información emergente explica por qué la preferida no respondió |
La contraseña y el token de acceso nunca aparecen en los registros de la integración.
Parámetros de configuración
Estos son los parámetros que Scrypted te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Gladys habla con su servidor Scrypted como lo hace la consola web de Scrypted. Indique la dirección local del servidor, la dirección de Scrypted Cloud o ambas: el interruptor «Preferir la conexión local» decide cuál se prueba primero, la otra toma el relevo cuando no responde. Use una cuenta de Scrypted creada para Gladys y, preferiblemente, un token de acceso en lugar de su contraseña. |
| Dirección local | string | No | La dirección del servidor Scrypted en su red, con su puerto: https://<ip>:10443/ por defecto. Se acepta su certificado autofirmado. |
| Dirección de Scrypted Cloud | string | No | La dirección que el plugin Scrypted Cloud da a su servidor (o su propio dominio detrás). Déjela vacía para quedarse en la red local. |
| Nombre de usuario | string | Sí | Un usuario de Scrypted (Ajustes, Usuarios). Un administrador ve todos los dispositivos; un usuario solo los que se le asignan. |
| Contraseña o token de acceso | secret | Sí | La contraseña de ese usuario o, mejor, un token de acceso: ejecute npx scrypted login en un ordenador de su red y pegue luego el token guardado en ~/.scrypted/login.json. Nunca se escribe en los registros. |
| Intervalo de imágenes de cámara (s) | number | No | Con qué frecuencia cada cámara envía una imagen nueva a Gladys, en segundos (mínimo 10). 0 solo envía imágenes en eventos y bajo demanda. |
| Imagen en cada evento | boolean | No | Envía una imagen nueva de la cámara cuando ve movimiento, un objeto o una pulsación del timbre. |
| Pausa entre detecciones (s) | number | No | Tras un evento «objeto detectado», la misma cámara espera estos segundos antes de volver a lanzarlo para el mismo tipo de objeto: una persona que pasa es un evento, no treinta. |
Cómo instalar Scrypted en Gladys
- En Gladys, abre Integraciones: Scrypted 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/prohand/gladys-scrypted:1.0.2), 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/prohand/gladys-scrypted.
Scrypted requiere Gladys >=5.1.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
Scrypted 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 prohand, 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