Tutoriel Home Assistant · Épisode 2

Intégrer une caméra Raspberry Pi dans Home Assistant avec Frigate

Dans la vidéo précédente, nous avons transformé la caméra du Raspberry Pi en caméra IP grâce à MediaMTX. Cette fois, nous poursuivons le projet : affichage dans Home Assistant, configuration de Frigate et détection de personnes par IA.

▶ Regarder le tutoriel Voir les étapes

🎯 L’objectif de cette vidéo

La caméra IP fonctionne déjà : nous ne recommençons pas sa fabrication. Nous réutilisons le flux RTSP de MediaMTX pour l’afficher dans Home Assistant, puis nous le donnons à Frigate afin d’analyser les images.

📷Caméra Raspberry Pi
Capture vidéo

📡MediaMTX
Flux RTSP

🏠Home Assistant
Affichage caméra

🧠Frigate
Détection IA

🛠️ Les étapes du tutoriel

1️⃣

Ajouter la caméra générique

Dans Home Assistant : Paramètres → Appareils et services → Ajouter une intégration → Caméra générique. Colle cette URL dans le champ « URL du flux vidéo ».

rtsp://192.168.1.44:8554/camera

Renseigne ensuite l’utilisateur et le mot de passe MediaMTX dans les champs d’authentification, puis sélectionne le transport TCP si cette option est proposée. L’adresse IP doit correspondre à celle de ton Raspberry Pi.

2️⃣

Installer Frigate

Dans Home Assistant, ouvre Paramètres → Modules complémentaires → Boutique, puis le menu en haut à droite ⋮ → Dépôts. Colle l’adresse ci-dessous, valide, puis recherche et installe Frigate.

https://github.com/blakeblackshear/frigate-hass-addons

Après avoir ajouté le dépôt, ferme la fenêtre des dépôts et actualise la boutique si nécessaire. Choisis ensuite l’add-on Frigate adapté à ton installation Home Assistant OS.

3️⃣

Déclarer le flux RTSP

Configurer la caméra dans Frigate pour que FFmpeg lise le flux de MediaMTX et fournisse les images au moteur de détection.

4️⃣

Activer le suivi des personnes

Configurer la détection et la classe d’objet « person », puis vérifier le résultat en passant devant la caméra.

⚙️ Exemple de configuration Frigate

Voici la structure utilisée pour déclarer la caméra. Remplace le texte de l’URL par les identifiants de ton installation. Ne publie jamais un mot de passe réel dans une page web ou une capture d’écran.

cameras:
  raspberry:
    enabled: true
    ffmpeg:
      inputs:
        - path: rtsp://UTILISATEUR:MOT_DE_PASSE@ADRESSE_IP:8554/camera
          roles:
            - detect
    detect:
      enabled: true
      width: 1280
      height: 720
      fps: 5
    objects:
      track:
        - person

⚠️ Important : cet exemple illustre la configuration de la caméra. Il doit être adapté à la configuration existante de Frigate. Si le mot de passe contient des caractères spéciaux, ils peuvent nécessiter un encodage dans l’URL.

🔎 Caméra générique ou Frigate : quelle différence ?

Caméra générique Home Assistant : affiche le flux vidéo dans le tableau de bord.
Frigate : analyse le flux et suit les objets configurés, par exemple les personnes.
MQTT et l’intégration Frigate : permettent ensuite de faire remonter les événements et entités dans Home Assistant pour créer des automatisations.

Les notifications sur téléphone sont une étape supplémentaire : elles nécessitent une automatisation Home Assistant et l’application mobile configurée.

❓ Questions fréquentes

La caméra fonctionne dans Home Assistant, est-ce suffisant ?

Pas tout à fait. Cela confirme l’affichage du flux. Il faut encore vérifier que Frigate reçoit la vidéo et que son détecteur identifie bien les personnes.

Que signifie « track: person » ?

Cette option demande à Frigate de suivre les personnes reconnues par son détecteur. La détection de mouvement et la reconnaissance d’une personne sont deux fonctions différentes.

Faut-il MQTT pour utiliser Frigate ?

Frigate peut fonctionner sans MQTT, mais l’intégration Home Assistant officielle nécessite MQTT pour faire remonter correctement la plupart des entités et événements. Il faut configurer le broker et l’activer dans Frigate.

📺 À voir également

Cette vidéo est la suite du projet de caméra Raspberry Pi : la caméra IP et son flux MediaMTX sont déjà en place. Ici, nous nous concentrons sur l’intégration Home Assistant et l’ajout de Frigate.

Tu as une question ou tu bloques sur une étape ? Laisse un commentaire sous la vidéo YouTube pour partager ton problème.

▶ Voir la vidéo sur YouTube