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 — Aide

Version : 1.1
Plateforme : macOS 26.4 ou ultérieur
Éditeur : Precellence

HomeCamCheck est une application macOS qui transforme une caméra connectée en outil de surveillance locale. Elle détecte les personnes sur votre Mac grâce au framework Vision d’Apple, affiche un aperçu en direct et peut envoyer des alertes ou s’intégrer à votre domotique.

Premiers pas

  1. Installez et lancez HomeCamCheck sur le Mac qui fera tourner la caméra.
  2. Accordez l’accès à la caméra lorsque macOS le demande. Sans cette autorisation, l’application ne peut ni afficher la vidéo ni effectuer la détection.
  3. La caméra démarre automatiquement à l’ouverture de l’app. Utilisez Arrêter la caméra / Démarrer la caméra (⌘K) dans la barre d’outils pour la contrôler.
  4. Dans la barre latérale, activez Détection pour commencer à rechercher des personnes dans le flux vidéo.

L’indicateur de statut indique si une personne est actuellement confirmée dans le champ de vision.

Fenêtre principale

Barre latérale

Contrôle Description
Détection Active ou désactive la détection de personnes sans arrêter la caméra.
Caméra Choisissez une caméra précise ou laissez Automatique pour laisser l’app en sélectionner une.
Notifications locales Alertes macOS lorsqu’une personne est détectée.
Telegram Envoie des alertes photo et/ou vidéo via votre bot Telegram.

Le pied de page affiche l’état du serveur webhook, du flux en direct et de l’archive vidéo locale.

Aperçu

La zone principale affiche le flux caméra en direct avec des surcouches de détection lorsqu’une personne est trouvée.

Apparence

Utilisez le sélecteur d’apparence dans la barre d’outils pour passer entre les thèmes clair et sombre.

Réglages

Ouvrez Réglages… depuis la barre latérale (ou HomeCamCheck → Réglages, ⌘,) pour les options avancées.

Caméra

  • Actualiser la liste des caméras — Met à jour la liste des caméras connectées.
  • Correction d’exposition — Ajuste la luminosité si votre caméra le permet.

Détection

  • Confiance minimale — Des valeurs plus élevées réduisent les faux positifs mais peuvent manquer des personnes éloignées.
  • Fréquence d’analyse (plafond FPS) — Fréquence d’analyse des images (1–30 FPS). Des valeurs plus basses consomment moins de CPU.
  • Images de lissage — Nombre de détections positives consécutives requises avant de confirmer une présence (réduit les à-coups).

Alertes

  • Alertes SMS — Envoie des SMS lorsqu’une personne est détectée. Choisissez un fournisseur dans Fournisseur SMS :
  • Free Mobile — API gratuite réservée aux abonnés Free Mobile. Activez Notifications par SMS dans votre espace abonné Free et saisissez votre identifiant et clé API.
  • Twilio — Compatible avec Orange, SFR, Bouygues, Free et les autres opérateurs. Nécessite un compte Twilio avec Account SID, Auth Token et numéros From/To vérifiés au format E.164 (ex. +33612345678).
  • Vonage — API SMS mondiale (ex-Nexmo). Nécessite une clé et un secret API plus un expéditeur et un numéro destinataire.
  • OVHcloud SMS — Service SMS cloud français. Nécessite des identifiants API OVH avec accès POST /sms/*/jobs, votre nom de service (ex. sms-xx000000-1) et un numéro destinataire.
  • Photo Telegram / vidéo Telegram — Envoie une capture et/ou un court clip lorsqu’une personne est détectée.
  • Délai minimum — Temps minimum entre deux alertes du même type (SMS ou Telegram).
  • Durée vidéo Telegram — Durée du clip enregistré (3–15 secondes).

Utilisez la section Tests pour vérifier les notifications, SMS et Telegram sans attendre une détection réelle.

Archive vidéo locale

Lorsqu’elle est activée, de courts clips vidéo sont enregistrés localement sur votre Mac lorsqu’une personne est détectée.

  • Rétention par durée — Supprime les clips plus anciens que le nombre de jours configuré.
  • Rétention par quota de stockage — Limite la taille totale de l’archive en mégaoctets.
  • Ouvrir le dossier — Ouvre le répertoire d’archive dans le Finder.
  • Purger maintenant — Supprime immédiatement les clips selon vos règles de rétention.

Contrôle à distance (webhook)

Un petit serveur HTTP sur 127.0.0.1 uniquement permet à Homebridge, Home Assistant ou des scripts d’allumer ou d’éteindre la caméra.

Point d’accès Méthode Action
/v1/camera/on GET Démarrer la caméra
/v1/camera/off GET Arrêter la caméra
/v1/camera POST Corps JSON : {"on": true} ou {"on": false}

Si vous définissez un jeton partagé, incluez-le dans l’en-tête X-HomeCamCheck-Token ou en paramètre ?token=.

Port par défaut : 37647 (configurable).

Flux en direct

Exporte un flux H.264 (Annex B) brut en TCP pour des outils comme homebridge-camera-ffmpeg ou ffplay.

  • Actif uniquement tant que la caméra tourne.
  • Lier à 127.0.0.1 uniquement — Recommandé pour la sécurité. Si désactivé, le flux est accessible sur votre réseau local.
  • Port par défaut : 47890.

Exemple de commande de test :

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

Consultez le fichier homebridge-http-webhooks.example.json fourni pour un exemple complet de configuration Homebridge.

Aide

Identifiants

Les valeurs sensibles sont stockées dans le Trousseau macOS, pas en clair :

  • Identifiant et clé API Free Mobile (fournisseur Free Mobile)
  • Account SID, Auth Token, numéro From et numéro To Twilio (fournisseur Twilio)
  • Clé API, secret API, expéditeur From et numéro To Vonage (fournisseur Vonage)
  • Application key, Application secret, Consumer key, nom de service, destinataire et expéditeur optionnel OVH (fournisseur OVH)
  • Jeton du bot Telegram et identifiant de conversation
  • Jeton partagé du webhook

Intégration Homebridge

HomeCamCheck prend en charge deux plugins Homebridge complémentaires :

  1. homebridge-http-webhooks — Allumage/extinction de la caméra via le webhook local.
  2. homebridge-camera-ffmpeg — Vidéo en direct via le flux TCP H.264.

Ils fonctionnent sur des ports différents et de manière indépendante. Copiez le JSON d’exemple fourni avec l’app et remplacez PASTE_YOUR_TOKEN_HERE par votre jeton webhook.

Dépannage

La caméra ne démarre pas

  • Vérifiez qu’aucune autre application n’utilise la caméra de façon exclusive.
  • Confirmez l’autorisation caméra dans Réglages système → Confidentialité et sécurité → Caméra.
  • Essayez Actualiser la liste des caméras et sélectionnez une autre caméra.

Trop ou pas assez de détections

  • Augmentez la Confiance minimale en cas de fausses alertes.
  • Augmentez les Images de lissage pour exiger une détection plus stable.
  • Réduisez la fréquence d’analyse si les performances sont insuffisantes.

SMS ou Telegram ne fonctionnent pas

  • Vérifiez les identifiants dans Réglages → Identifiants.
  • Utilisez le bouton Test correspondant.
  • Pour Telegram, assurez-vous que votre bot peut envoyer des messages à l’identifiant de conversation configuré.
  • Pour Free Mobile, confirmez que l’API SMS est activée sur votre compte.
  • Pour Twilio, vérifiez que le numéro From est validé et que les numéros sont au format E.164 (ex. +33612345678).
  • Pour Vonage, vérifiez la clé/le secret API et que l’expéditeur est autorisé dans votre pays.
  • Pour OVH, confirmez que la consumer key a les droits POST /sms/*/jobs et que le nom de service est correct.

Webhook ou flux inaccessible

  • Vérifiez que la fonctionnalité est activée dans les Réglages.
  • Contrôlez que le port n’est pas déjà utilisé.
  • Le webhook n’écoute que sur 127.0.0.1. Les machines distantes doivent atteindre votre Mac via votre propre configuration réseau si vous exposez le flux sur le LAN.

L’archive grossit trop

  • Activez la rétention par durée et/ou par quota.
  • Utilisez Purger maintenant pour nettoyer immédiatement.

Raccourcis clavier

Raccourci Action
⌘K Démarrer / arrêter la caméra
⌘, Ouvrir les Réglages

Confidentialité

HomeCamCheck traite la vidéo localement sur votre Mac. Les alertes optionnelles n’envoient des données qu’aux services que vous configurez (Telegram, Free Mobile, Twilio, Vonage, OVH). Consultez la Politique de confidentialité pour plus de détails.

Contact

Pour l’assistance ou vos retours : support@precellence.icu

Dernière mise à jour : juin 2026