plugin-frigate

Plugin créé par Sagitaz et Noodom

Remerciemment

Le plugin et le support sont gratuits, vous souhaitez néanmoins m’offrir un café ou des couches pour bébé, je vous remercie par avance.

ko-fi

Aide et Support

Pour toute demande d’aide sur Community ou Discord, merci de fournir le maximum d’informations possibles.

Sur la page configuration, le bouton assistance permet déjà d’en remplir automatiquement certaines.

Donner aussi des logs en mode debug. Aucun support ne sera apporté sur d’autres moyens de communication que ceux-ci. Merci

Pré-requis

Le plugin n’installe pas et ne configure pas le serveur Frigate, il vous faut donc l’installer et le configurer vous-même. Voir la documentation officielle de Frigate pour plus d’informations.

Installation

Comme pour tous les autres plugins, après l’avoir installé, il faut l’activer.

Le plugin sera toujours compatible avec la dernière version stable connue (le temps de s’adapter). Par contre, on ne fera pas plusieurs développements pour rester opérationnel avec les anciennes versions. Donc si quelque chose ne fonctionne pas, commencez par mettre à jour votre serveur Frigate avant de demander de l’aide.

Au 08-06-2025 le plugin fonctionne avec les versions suivantes de Frigate :

Mode de connexion au serveur Frigate

API

La récupération des caméras, des anciens évènements, la suppression d’évènements, etc… De nombreuses fonctions du plugin utilisent la connexion à l’API Frigate. Celle-ci est accessible par le port 5000 sur votre réseau local, il est impératif que vous l’ayez configuré, sans quoi le plugin ne pourra fonctionner. Si vous souhaitez utiliser un autre port, vous pouvez le faire du moment que vous mappez vers le port 5000 (5054:5000) dans la configuration du serveur Frigate.

MQTT

La configuration MQTT permet de recevoir les informations du serveur Frigate en temps réel. Cela améliore l’expérience utilisateur du plugin, mais n’est pas nécessaire pour son fonctionnement. Un broker sécurisé (user:mdp) est obligatoire pour que le plugin mqtt-manager dont dépend le plugin frigate fonctionne correctement.

Log

Le plugin comporte des sous-logs, pour qu’ils soient visibles sur jeedom 4.4.19, il est nécessaire de passer les logs globaux en niveau info minimum.

niveau de logs

Configuration

Paramétrage Frigate

Gestion des évènements

Le nombre de jours de suppression ne peut pas être plus petit que le nombre de jours de récupération. Dans le cas contraire, ce sera alors le nombre de jours de récupération qui sera utilisé.

Fonctionnalités

Demon

Le démon démarre automatiquement après avoir sauvegardé la partie configuration et y avoir configuré le topic Frigate. Pour pouvoir utiliser MQTT, il faut que vous ayez correctement configuré votre serveur Frigate et que vous ayez le plugin mqtt-manager (mqtt2) installé et correctement configuré. Votre broker MQTT doit être sécurisé pour que le plugin mqtt-manager fonctionne. Si vous utilisez MQTT, vous pouvez mettre le cron à Hourly ou Daily.

Deamon NOK : Si vous n’avez pas mqtt-manager, il est normal que le démon reste sur NOK. Aucun problème, le plugin fonctionne quand même, cependant certaines fonctions seront indisponibles ou limitées.

Utilisation

Les commandes infos de tous les équipements sont créées automatiquement à la prochaine réception d’événements ou de statistiques. Si vous ne les voyez pas à la première installation du plugin, c’est que vos événements récents ont plus de 3 heures, il faut donc attendre le prochain événement pour voir les commandes.

Les commandes actions sont créées seulement quand vous utiliser le bouton “Rechercher / MAJ”.

Equipement Events

L’équipement est créé de manière automatique en même temps que les caméras. Celui-ci comporte des commandes infos avec la valeur du dernier évènement reçu. Il comporte aussi 2 commandes actions : cron start et cron stop, ceci afin de mettre en pause la recherche de nouveaux évènements.

Il est possible de créer des actions communes à toutes les caméras (voir la section dédiée) Cocher “autoriser les actions” si vous souhaitez sur une détection exécuter les actions présentes dans l’équipement events et dans les équipements caméras.

Equipement Statistiques

L’équipement est créé de manière automatique en même temps que les caméras. Celui-ci comporte des commandes infos avec quelques statistiques disponibles.

Il comporte aussi la commande action permettant de redémarrer le serveur Frigate.

Equipement Caméra

Après installation du plugin et la configuration de l’URL et du port de votre serveur Frigate, il vous suffit de cliquer sur le bouton Rechercher. Les caméras trouvées seront automatiquement créées. Il est nécessaire de patienter car à la première recherche sont également importés les évènements de la dernière journée. Cela peut prendre un peu de temps.

Equipement

A droite, les quelques paramètres disponibles pour la visualisation. Refresh de l’image suivant votre configuration.

Commandes infos

Toutes les caméras

Les informations sur le dernier évènement de la caméra et sur ses statistiques.

L’info LABEL correspond à l’objet qui a déclenché la détection (person, vehicle, cat, dog, etc…)

MQTT

Commandes actions

Pour avoir les commandes actions suivantes, il est obligatoire d’utiliser MQTT. Sans cela, les commandes ne seront pas créées. Je vous invite à lire la documentation de Frigate pour la configuration de votre serveur MQTT.

Les commandes PTZ, preset et audio ne sont créées que si la configuration de votre serveur Frigate possède les informations.

Action(s) sur évènement

Les actions sur évènements sont disponible pour l’équipement Events et pour chaque équipement caméras. Les actions configurées sur l’équipement Events seront exécutées par les évènements provenant de toutes les caméras sauf si elles possèdent des actions configurées et activées. Si vous souhaitez regrouper sur l’équipement Events des actions communes et ensuite ajouter des actions pour chaque caméra, pensez à cocher sur l’équipement Events la case “autoriser les actions”.

Déroulé de l'action :

execution d'une action

Conditions générales

Indiquer ici dans quel cas les actions NE DOIVENT PAS être exécutées.

Par exemple, vous configurez la condition comme ceci : #[Maison][Mode maison][Mode]# == “présent” Les actions ne seront exécutées que si le mode est tout autre que présent.

Actions

Vous pouvez indiquer ici les actions à effectuer à chaque nouvel évènement.

Une checkbox vous permet de désactiver la vérification de la condition génèrale.

LABEL : Pour rappel, le label est ce qui déclenche la détection (person, vehicle, animal, etc…) Dans la case label, il vous suffit d’indiquer le(s) label(s) pour lesquels vous souhaitez que l’action soit exécutée. Si ce champ est vide ou que vous mettez all, alors l’action sera exécutée pour tous les nouveaux évènements. Vous pouvez indiquer plusieurs labels en les séparant par des virgules. Les majuscules et les accents sont ignorés, donc si vous indiquez “Vélo” ou “velo”, les deux seront considérées comme identiques.

TYPE : Avec MQTT, ils peuvent être de type new, update et end. Sans MQTT, il sera toujours de type end. Dans la case type, il vous suffit d’indiquer le type pour lequel vous souhaitez que l’action soit exécutée. Vous pourvez en mettre plusieurs en les séparant par des virgules. Si aucun type n’est spécifié, l’action sera exécutée seulement pour les évènements de type end. les majuscules et les accents sont ignorés, donc si vous indiquez “update” ou “UPDATE”, les deux seront considérées comme identiques.

ZONES :

Dans la case zone d’entrée, il vous suffit d’indiquer la ou les zones pour lesquelles vous souhaitez que l’action soit exécutée. Vous pouvez indiquer plusieurs zones en les séparant par des virgules.

La case zone de sortie permet de gérer le sens de la détection. Cela ne fonctionne qu’avec une zone d’entrée définie. Si la zone d’entrée est déclenchée avant la zone de sortie alors l’action sera exécutée.

Les majuscules et les accents sont ignorés, donc si vous indiquez “Allée” ou “allee”, les deux seront considérées comme identiques.

CONDITION DE L'ACTION : Indiquer ici dans quel cas les actions DOIVENT être exécutées.

Par exemple, vous configurez la condition comme ceci : #[Maison][Mode maison][Mode]# == “absent” Les actions ne seront exécutées que si le mode est configuré comme absent.

Si aucune condition n’est spécifiée, l’action sera réalisée.

Variables disponibles pour les conditions:

Variables disponibles pour les actions: Une liste de variables est disponible afin de personnaliser les actions, ces variables sont remplacées par leur valeur lors de l’exécution de l’action.

Exemple de notifications :

Plugin JeeMate

Pour une notification automatique, ajouter frigate=#jeemate#, disponible avec la future v3 de JeeMate

Plugin Telegram

Testez les 2 commandes snapshot. Selon les configurations, il se peut qu’une des deux ne fonctionne pas.

Plugin Mobile v2

Plugin JeedomConnect

Plugin NTFY

Page Events

Evènement :

cadre évènement

    • Mettre l’évènement en favori
    • lien vers la caméra
    • Visualiser le snapshot (simple clic sur l’icone)
    • Télécharger le snapshot (double clic sur l’icone)
    • Visualiser le clip (simple clic sur l’icone)
    • Télécharger le clip (double clic sur l’icone)
    • Supprimer l’évènement
    • Description de l’évènement (si genAI activé)

ATTENTION : le bouton “supprimer” supprime l’évènement en database Jeedom mais aussi sur votre serveur Frigate. En aucun cas, je ne serai responsable de votre mauvaise utilisation de ce bouton. Néanmoins, une popup de confirmation est présente.

Les évènements mis en favoris ne sont pas supprimés.

page évènements

    • supprimer tous les évènements visibles ATTENTION : Le bouton “supprimer tous les évènements visibles” fera exactement ce qu’il annonce, donc appliquez bien les bons filtres avant de supprimer : aucun retour en arrière ne sera possible : une popup de confirmation est présente. La suppression est effectuée en database Jeedom mais aussi sur votre serveur Frigate.
    • Création d’un évènement manuel Dans la configuration générale du plugin Frigate, vous pouvez indiquer les valeurs par défaut des évènements créés manuellement. Sur la page Events, vous trouverez un bouton permettant de créer un nouvel évènement. Pour chaque caméra, une commande action vous permettra aussi de créer un évènement. Cette commande est de type message. Si vous laissez vide alors les paramètres par défaut seront utilisés (depuis le widget ce sera toujours le cas). title : Indiquer le label message : score=80 | video=1 | duration=20 Pour la durée des clips, il faut penser aussi au fait que Frigate ajoute du temps avant et après la vidéo, 5 sec. par defaut, donc en paramétrant à 20 sec. vous obtiendrez une vidéo de 30 sec. Attention sur les évènements créés manuellement, si dans votre configuration Frigate pour record -> retain -> mode vous avez motion alors les clips ne seront disponibles que s’il y a du mouvement de detecté, mettre à all si vous voulez tout avoir.
    • Filtrer les évènements Afficher seulement les événements d’une ou plusieurs caméras, seulement d’un label ou d’un type d’événement, seulement les événements de la semaine ou de l’année en cours, etc…

Création d’une capture instantanée

Vous ne souhaitez pas créer un évènement manuellement, mais vous souhaitez avoir une capture instantanée de la caméra ? Vous pouvez créer une action sur la caméra qui va capturer l’image de la caméra.

Dans les actions des caméras se trouvent deux commandes :

L’URL est de la forme /plugins/frigate/data/caméra/id_snapshot.jpg afin de s’adapter au maximum de plugins de communication.

Par exemple si vous souhaitez une URL complète, vous pouvez mettre ceci dans configuration, calcul et arrondi de la commande info : str_replace('"','',"https://monjeedom.eu.jeedom.link"#value#)

Ou bien pour ceux ayant besoin du path :

str_replace('"','',"/var/www/html"#value#)

Configuration Frigate

ATTENTION : La modification de la configuration du serveur Frigate est à vos risques et périls ! Aucun support ne sera donné !

Logs Frigate

Visualiser tous les logs de votre serveur Frigate

Cron

Si vous n’utilisez pas MQTT : un cron régulier vous permet de récupérer les derniers events et donc d’exécuter les actions associées.

Si vous utilisez MQTT : tous les nouveaux events sont reçus automatiquement, un cron heure ou jour est suffisant : il permet de mettre à jour les infos de l’évènement.

Dans tous les cas, laisser au moins un cron actif car il sera vérifié à chaque fois si les fichiers sauvegardés correspondent bien à un évènement et dans le cas contraire, ils seront supprimés.

Le cronDaily est le seul à vérifier la version de votre serveur frigate : si une maj est disponible, vous aurez un message.

Mon conseil : Sans MQTT : cron ou cron5 (suivant puissance machine) + cronDaily Avec MQTT : cronDaily

Dans tous les cas, si un cron est en cours d’exécution, le suivant ne sera pas lancé et en MQTT, les cron (1, 5, 10 et 15 sont désactivès).

Widget

Vous y trouverez la visualisation de la caméra et les boutons cochés visibles.

Flux vidéo

configuration

Dans le plugin Frigate il n’y a pas de lecteur pour le flux vidéo, cette configuration sert pour les plugins compatibles.

L’URL du flux vidéo enregistré dans le plugin est celle de votre serveur Frigate et pas celle de la caméra.

  1. Flux RTSP de Frigate :
    • Avantages : Frigate peut centraliser les flux de plusieurs caméras, ce qui réduit le nombre de connexions directes à chaque caméra. Cela peut améliorer la stabilité et la gestion des ressources réseau.
    • Inconvénients : La configuration peut être plus complexe, surtout si vous avez plusieurs caméras avec des paramètres différents.
  2. Flux RTSP de la caméra :
    • Avantages : Utiliser directement le flux RTSP de la caméra peut être plus simple à configurer, surtout si vous avez une seule caméra ou si vous ne souhaitez pas utiliser de logiciel intermédiaire.
    • Inconvénients : Chaque appareil se connectera directement à la caméra, ce qui peut augmenter la charge sur le réseau et sur la caméra elle-même.

En résumé, si vous avez plusieurs caméras et que vous souhaitez une gestion centralisée, le flux RTSP de Frigate pourrait être plus avantageux. Si vous préférez une solution plus simple et directe, utiliser le flux RTSP de la caméra pourrait être suffisant.

Avec JeeMate

Si votre configuration Frigate comporte plusieurs flux par caméra, il vous faudra indiquer dans le champ flux vidéo de votre équipement celui que vous souhaitez utiliser, la même chose si vous préférez utiliser le fux d’origine de la caméra.

Configuration Frigate avec un seul flux, ici je n’ai pas besoin d’indiquer le flux, celui par défaut conviendra.

frigate1:
  ffmpeg:
    inputs:
      - path: rtsp://127.0.0.1:8554/frigate1

Configuration Frigate avec plusieurs flux, indiquer l’url du flux voulu sur la page de votre équipement , celui par defaut ne conviendra pas, remplacer 127.0.0.1 par l’ip du serveur Frigate.

    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/frigate1_high  # Flux principal haute résolution
          input_args: preset-rtsp-restream
          roles:
            - record        # Utilisé pour l’enregistrement
        - path: rtsp://127.0.0.1:8554/frigate1_low   # Flux secondaire basse résolution
          input_args: preset-rtsp-restream
          roles:
            - detect

Attention, en aucun cas il ne vous est demandé de modifier la configuration sur Frigate

Après chaque modification de l’URL du flux dans le plugin Frigate, il vous faudra sauvegarder aussi dans le plugin JeeMate puis faire une synchronisation complète dans l’application.

Panel

N’oubliez pas d’activer la page panel dans la configuration générale, puis pour chaque caméra de cocher la case “Panel”.

FAQ

Le plugin est bien configuré en MQTT mais aucune action n’est effectuée

Le topic frigate/reviews correspond aux review items (périodes d’activité détectée) qui sont générés après la détection et l’enregistrement des objets. Ce système de revue s’appuie fortement sur la fonction d’enregistrement (recording) pour fonctionner :

Frigate organise les review items comme des plages temporelles regroupant plusieurs détections

Si l’enregistrement est désactivé (record.enabled: false), aucun segment vidéo n’est stocké, et donc la plateforme ne construit pas de review items → rien n’est publié dans frigate/reviews.

Pour fonctionner le plugin a donc besoin de :

record:
  enabled: true

Exemple de fichier de configuration

Veuillez noter que c’est mon fichier, mes réglages et qu’il fonctionne pour ma situation, à vous de l’adapter ou de comparer avec le vôtre si jamais toutes les fonctions du plugin n’étaient pas fonctionnelles chez vous.

Je ne pourrais être tenu responsable de tout dysfonctionnement causé par cette configuration, vous devez donc adapter la configuration à votre propre serveur et à vos besoins.

J’ai mis des commentaires afin de vous aider.

 # Rappel, le plugin mqtt-manager nécéssite un broker mqtt sécurisé.
 mqtt:
  host: 192.168.2.22        # Adresse IP de votre serveur MQTT
  port: 1883                # Port du broker MQTT (1883 = standard non sécurisé)
  user: ***                 # Nom d'utilisateur (masqué ici)
  password: ***             # Mot de passe (masqué ici)
  stats_interval: 300       # Fréquence (en secondes) des messages de statistiques MQTT

detectors:
  coral:
    type: edgetpu           # Utilise un accélérateur Coral (Edge TPU) pour la détection
    device: usb             # Type de connexion : USB

ffmpeg:
  hwaccel_args: preset-intel-qsv-h264  # Accélération matérielle Intel Quick Sync pour le décodage vidéo

timestamp_style:
  position: tr              # Position du timestamp sur l’image (tr = top-right = coin supérieur droit)
  format: '%d/%m/%Y %H:%M:%S'  # Format du timestamp affiché (jour/mois/année heure:min:sec)

birdseye:
  enabled: false            # Désactive le mode Birdseye (vue multi-caméras combinée)

model:
  labelmap:                 # Remappage des classes de détection vers des noms personnalisés
    0: personne
    1: vehicule
    2: vehicule
    3: vehicule
    5: vehicule
    7: vehicule
    16: animale
    17: animale
    18: animale
    19: animale
    20: animale

detect:
  enabled: true             # Active globalement la détection d'objets pour toutes les caméras (ajouté automatiquement par frigate 0.16)

snapshots:
  enabled: true             # Active les captures d’image (snapshots) lors des événements
  clean_copy: true          # Génère une version sans annotation (utile pour archivage ou IA)
  timestamp: false          # Ne superpose pas la date/heure sur les images
  bounding_box: false       # Ne dessine pas de boîte de détection sur les images
  crop: false               # Ne recadre pas automatiquement l’objet détecté
  retain:                   # Durée de conservation des images
    default: 3              # Par défaut, conserve les snapshots 3 jours
    objects:
      personne: 7           # Conserve ceux contenant une "personne" pendant 7 jours
      vehicule: 3           # Conserve ceux contenant un "vehicule" pendant 3 jours

record:
  enabled: true             # Active l’enregistrement vidéo, obligatoire pour que le plugin reçoive les événements.
  retain:
    days: 1                 # Conserve les enregistrements pendant 1 jour
    mode: all               # Enregistre tout, même sans détection
  alerts:
    retain:
      days: 7               # Conserve les clips d’alerte pendant 7 jours
      mode: active_objects  # Seulement si un objet actif a été détecté
    pre_capture: 5          # Enregistre 5 secondes avant le début de l’événement
    post_capture: 5         # Enregistre 5 secondes après la fin de l’événement
  detections:
    retain:
      days: 7               # Conserve les clips avec détection pendant 7 jours
      mode: active_objects
    pre_capture: 3
    post_capture: 5

semantic_search:
  enabled: true             # Active l’analyse sémantique des événements (IA)
  reindex: false            # Ne re-analyse pas les anciens événements au démarrage

genai:
  enabled: true             # Active l’intégration IA (Google Gemini ici)
  provider: gemini          # Fournisseur de l’IA
  api_key: ***              # Clé API Gemini (masquée ici)
  model: gemini-1.5-flash   # Modèle utilisé pour l’analyse comportementale
  object_prompts:          # Prompts personnalisés pour chaque type d’objet, a vous de l'adapter si besoin.
    personne: >
      Commence IMMÉDIATEMENT et DIRECTEMENT la description de l'action...
    vehicule: >
      Décris IMMÉDIATEMENT et DIRECTEMENT le comportement du véhicule...
    animale: >
      Analyse IMMÉDIATEMENT et DIRECTEMENT le comportement de l'animal...

cameras:
  frigate1:                 # Nom de la caméra
    detect:
      fps: 5                # Taux d’analyse des images pour la détection
      enabled: true         # Active la détection pour cette caméra
      width: 640            # Largeur du flux vidéo analysé
      height: 360           # Hauteur du flux vidéo analysé
      stationary:
        interval: 50        # Vérifie les objets immobiles toutes les 50 frames
        threshold: 30       # Seuil de mouvement à partir duquel un objet est considéré comme "mobile"
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/frigate1_high  # Flux principal haute résolution
          input_args: preset-rtsp-restream
          roles:
            - record        # Utilisé pour l’enregistrement
        - path: rtsp://127.0.0.1:8554/frigate1_low   # Flux secondaire basse résolution
          input_args: preset-rtsp-restream
          roles:
            - detect        # Utilisé pour la détection
    objects:
      track:                # Liste des objets à détecter
        - personne
        - vehicule
        - animale
      filters:              # Filtres pour chaque type d’objet
        personne:
          min_score: 0.65   # Score minimum pour commencer à suivre
          threshold: 0.7    # Score minimum pour déclencher un événement
        vehicule:
          min_score: 0.7
          threshold: 0.8
        animale:
          min_score: 0.7
          threshold: 0.8

go2rtc:
  streams:                  # Flux vidéo déclarés pour usage interne (re-streaming)
    frigate1_low: rtsp://***:***@192.168.2.36:554/2   # Flux basse qualité
    frigate1_high: rtsp://***:***@192.168.2.36:554/1  # Flux haute qualité

version: 0.16-0             # Version utilisée de Frigate
This site is open source. Improve this page.