title: WhoRang created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, artificial-intelligence, home-assistant, doorbell, camera, python] confidence: medium contested: false sources: [https://selfh.st/apps/?search=whorang]

WhoRang 🔔

Sonnette connectée et caméra de porte IA, auto-hébergée, qui reconnaît les visiteurs et notifie via Home Assistant.

Métadonnée	Valeur
Site web	https://whorang.io
GitHub	https://github.com/whorang/whorang
License	MIT
Langage	Python
Étoiles	9
Dernière MAJ	2026-02
Catégorie	cat-artificial-intelligence

Description

WhoRang est une application domotique qui transforme n'importe quelle caméra IP ou un Raspberry Pi + module caméra en sonnette intelligente auto-hébergée. Le logiciel détecte les mouvements près de la porte, identifie les visages (modèle FaceNet local), distingue visiteurs, livreurs, voisins et inconnus, puis envoie des notifications enrichies avec miniature, nom et historique de la personne à Home Assistant, Telegram, Gotify ou ntfy.

L'interface web permet d'armer/désarmer l'alerte, de gérer une base de données de visages connus, de revoir les événements et de configurer des automatisations (déclencher une lumière, ouvrir un portier IP, envoyer un message vocal). L'intégration native avec Home Assistant (via MQTT) permet d'enchaîner des scénarios domotiques plus complexes.

Le projet est jeune, peu étoilé (9 ⭐) et l'écosystème reste limité, mais il s'adresse clairement aux bricoleurs qui refusent les sonnettes cloud (Ring, Nest) pour des raisons de confidentialité. Une caméra USB standard suffit pour démarrer. Note de confiance : low car le projet évolue vite, l'API peut casser entre versions mineures, et la documentation est encore fragmentaire.

Installation

Docker Compose

services:
  whorang:
    image: ghcr.io/whorang/whorang:latest
    container_name: whorang
    restart: unless-stopped
    ports:
      - "8124:8124"
    devices:
      - /dev/video0:/dev/video0  # caméra USB (optionnel)
    environment:
      - WHORANG_SECRET_KEY=${WHORANG_SECRET_KEY}
      - MQTT_HOST=mqtt
      - MQTT_PORT=1883
      - MQTT_USER=${MQTT_USER}
      - MQTT_PASS=${MQTT_PASS}
      - HA_URL=http://homeassistant:8123
      - HA_TOKEN=${HA_TOKEN}
    volumes:
      - whorang_data:/app/data
    depends_on:
      - mqtt

  mqtt:
    image: eclipse-mosquitto:2
    restart: unless-stopped
    ports:
      - "1883:1883"
    volumes:
      - mqtt_data:/mosquitto/data
      - mqtt_conf:/mosquitto/config

volumes:
  whorang_data:
  mqtt_data:
  mqtt_conf:

Manuelle (Raspberry Pi)

git clone https://github.com/whorang/whorang.git
cd whorang
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m whorang --camera 0

Configuration

Premier lancement : créer un compte admin via http://IP:8124, ajouter une caméra (URL RTSP ou index /dev/video0), entraîner la base de visages en uploadant des photos de référence. Le réseau local doit être stable (faible latence caméra → conteneur). Sur Raspberry Pi, limiter la résolution d'analyse à 640×480 pour rester fluide.

Alternatives

Open source : app-frigate (détection + reconnaissance), app-motioneye, app-zoneminder, app-agent-dvr, app-home-assistant (intégrations)
Propriétaire : Ring (Amazon), Nest Doorbell (Google), Arlo, Eufy, Reolink (cloud partiel)

Sécurité

Une caméra de sonnette filme la rue et le visage des passants : il s'agit potentiellement de données biométriques soumises au RGPD. Limiter la rétention (purge auto après 7–30 jours), chiffrer le volume whorang_data (LUKS), isoler le conteneur sur un VLAN IoT. Activer HTTPS via reverse-proxy (Caddy/Traefik). Désactiver l'accès WAN sauf via VPN (Tailscale, WireGuard). Surveiller les mises à jour — projet jeune, CVE probables.

Ressources

Dépôt GitHub : https://github.com/whorang/whorang
Forum communautaire : https://community.home-assistant.io
Licence : MIT
Statut : beta, API instable

4.2 KiB Raw Permalink Blame History Unescape Escape