EN FR ES
Coming soon

Mac App Store release in preparation

HomeCamCheck is not yet available for download. Documentation is published in advance.

HomeCamCheck app icon

HomeCamCheck

Local macOS surveillance — person detection, alerts and smart home integration.

Documentation

HomeCamCheck — Ayuda

Versión: 1.1
Plataforma: macOS 26.4 o posterior
Editor: Precellence

HomeCamCheck es una aplicación para macOS que convierte una cámara conectada en una herramienta de vigilancia local. Detecta personas en su Mac mediante el framework Vision de Apple, muestra una vista previa en directo y puede enviar alertas o integrarse con su hogar inteligente.

Primeros pasos

  1. Instale y abra HomeCamCheck en el Mac que utilizará la cámara.
  2. Conceda acceso a la cámara cuando macOS lo solicite. Sin este permiso, la aplicación no puede mostrar vídeo ni realizar detecciones.
  3. La cámara se inicia automáticamente al abrir la app. Use Detener cámara / Iniciar cámara (⌘K) en la barra de herramientas para controlarla.
  4. En la barra lateral, active Detección para empezar a buscar personas en el flujo de vídeo.

El indicador de estado muestra si hay una persona confirmada en el encuadre.

Ventana principal

Barra lateral

Control Descripción
Detección Activa o desactiva la detección de personas sin detener la cámara.
Cámara Elija una cámara concreta o deje Automática para que la app seleccione una.
Notificaciones locales Alertas de macOS cuando se detecta una persona.
Telegram Envía alertas con foto y/o vídeo mediante su bot de Telegram.

El pie de página muestra el estado del servidor webhook, del flujo en directo y del archivo de vídeo local.

Vista previa

El área principal muestra el flujo de la cámara en directo con superposiciones de detección cuando se encuentra una persona.

Apariencia

Use el selector de apariencia en la barra de herramientas para alternar entre los temas claro y oscuro.

Ajustes

Abra Ajustes… desde la barra lateral (o HomeCamCheck → Ajustes, ⌘,) para las opciones avanzadas.

Cámara

  • Actualizar lista de cámaras — Actualiza la lista de cámaras conectadas.
  • Compensación de exposición — Ajusta el brillo si su cámara lo permite.

Detección

  • Confianza mínima — Valores más altos reducen los falsos positivos pero pueden omitir personas lejanas.
  • Frecuencia de análisis (límite FPS) — Con qué frecuencia se analizan los fotogramas (1–30 FPS). Valores más bajos consumen menos CPU.
  • Fotogramas de suavizado — Número de detecciones positivas consecutivas necesarias antes de confirmar presencia (reduce parpadeos).

Alertas

  • Alertas SMS — Envía mensajes de texto cuando se detecta una persona. Elija un proveedor en Proveedor SMS:
  • Free Mobile — API gratuita solo para abonados Free Mobile. Active Notifications par SMS en su cuenta Free Mobile e introduzca su usuario y clave API.
  • Twilio — Compatible con Orange, SFR, Bouygues, Free y otros operadores. Requiere una cuenta Twilio con Account SID, Auth Token y números From/To verificados en formato E.164 (p. ej. +33612345678).
  • Vonage — API SMS global (ex-Nexmo). Requiere clave y secreto API más un remitente y número destinatario.
  • OVHcloud SMS — Servicio SMS cloud francés. Requiere credenciales API OVH con acceso POST /sms/*/jobs, su nombre de servicio (p. ej. sms-xx000000-1) y un número destinatario.
  • Foto Telegram / vídeo Telegram — Envía una captura y/o un clip corto cuando se detecta una persona.
  • Tiempo de espera — Tiempo mínimo entre dos alertas del mismo tipo (SMS o Telegram).
  • Duración del vídeo Telegram — Duración del clip grabado (3–15 segundos).

Use la sección Pruebas para verificar notificaciones, SMS y Telegram sin esperar una detección real.

Archivo de vídeo local

Cuando está activado, se guardan clips de vídeo cortos localmente en su Mac cuando se detecta una persona.

  • Retención por tiempo — Elimina clips más antiguos que el número de días configurado.
  • Retención por límite de almacenamiento — Limita el tamaño total del archivo en megabytes.
  • Abrir carpeta — Abre el directorio del archivo en el Finder.
  • Purgar ahora — Elimina inmediatamente los clips según sus reglas de retención.

Control remoto (webhook)

Un pequeño servidor HTTP solo en 127.0.0.1 permite a Homebridge, Home Assistant o scripts encender o apagar la cámara.

Endpoint Método Acción
/v1/camera/on GET Iniciar la cámara
/v1/camera/off GET Detener la cámara
/v1/camera POST Cuerpo JSON: {"on": true} o {"on": false}

Si configura un token compartido, inclúyalo en la cabecera X-HomeCamCheck-Token o como parámetro ?token=.

Puerto predeterminado: 37647 (configurable).

Flujo en directo

Exporta un flujo H.264 (Annex B) en bruto por TCP para herramientas como homebridge-camera-ffmpeg o ffplay.

  • Activo solo mientras la cámara está en funcionamiento.
  • Vincular solo a 127.0.0.1 — Recomendado por seguridad. Si se desactiva, el flujo es accesible en su red local.
  • Puerto predeterminado: 47890.

Ejemplo de comando de prueba:

ffplay -fflags +genpts -f h264 tcp://127.0.0.1:47890

Consulte el archivo homebridge-http-webhooks.example.json incluido para un ejemplo completo de configuración de Homebridge.

Ayuda

Credenciales

Los valores sensibles se almacenan en el Llavero de macOS, no en texto plano:

  • Usuario y clave API de Free Mobile (proveedor Free Mobile)
  • Account SID, Auth Token, número From y número To de Twilio (proveedor Twilio)
  • Clave API, secreto API, remitente From y número To de Vonage (proveedor Vonage)
  • Application key, Application secret, Consumer key, nombre de servicio, destinatario y remitente opcional de OVH (proveedor OVH)
  • Token del bot de Telegram e ID del chat
  • Token compartido del webhook

Integración con Homebridge

HomeCamCheck admite dos complementos de Homebridge complementarios:

  1. homebridge-http-webhooks — Encendido/apagado de la cámara mediante el webhook local.
  2. homebridge-camera-ffmpeg — Vídeo en directo mediante el flujo TCP H.264.

Funcionan en puertos distintos e independientemente. Copie el JSON de ejemplo incluido con la app y sustituya PASTE_YOUR_TOKEN_HERE por su token de webhook.

Solución de problemas

La cámara no inicia

  • Compruebe que ninguna otra aplicación esté usando la cámara de forma exclusiva.
  • Confirme el permiso de cámara en Ajustes del sistema → Privacidad y seguridad → Cámara.
  • Pruebe Actualizar lista de cámaras y seleccione otra cámara.

Demasiadas o pocas detecciones

  • Aumente la Confianza mínima si hay falsas alarmas.
  • Aumente los Fotogramas de suavizado para exigir una detección más estable.
  • Reduzca la frecuencia de análisis si hay problemas de rendimiento.

SMS o Telegram no funcionan

  • Verifique las credenciales en Ajustes → Credenciales.
  • Use el botón Prueba correspondiente.
  • Para Telegram, asegúrese de que su bot puede enviar mensajes al ID de chat configurado.
  • Para Free Mobile, confirme que la API SMS está activada en su cuenta.
  • Para Twilio, verifique que el número From está validado y que los números usan formato E.164 (p. ej. +33612345678).
  • Para Vonage, compruebe la clave/secreto API y que el remitente está permitido en su país.
  • Para OVH, confirme que la consumer key tiene derechos POST /sms/*/jobs y que el nombre de servicio es correcto.

Webhook o flujo inaccesible

  • Asegúrese de que la función está activada en Ajustes.
  • Compruebe que el puerto no esté ya en uso.
  • El webhook solo escucha en 127.0.0.1. Las máquinas remotas deben alcanzar su Mac mediante su propia configuración de red si expone el flujo en la LAN.

El archivo crece demasiado

  • Active la retención por tiempo y/o por límite de almacenamiento.
  • Use Purgar ahora para limpiar de inmediato.

Atajos de teclado

Atajo Acción
⌘K Iniciar / detener cámara
⌘, Abrir Ajustes

Privacidad

HomeCamCheck procesa el vídeo localmente en su Mac. Las alertas opcionales solo envían datos a los servicios que usted configure (Telegram, Free Mobile, Twilio, Vonage, OVH). Consulte la Política de privacidad para más detalles.

Contacto

Para soporte o comentarios: support@precellence.icu

Última actualización: junio de 2026