[Beta-Modul] FrigateHub - Frigate-Videoanalyse in IP-Symcon: Erkennungen, Kachel mit Livevideo, Archiv und Alarmanlage

Symcon PHP-Module (Diskussion)
1

Hallo zusammen,

heute stelle ich ein neues, eigenständiges Modul vor: FrigateHub.

Frigate ist eine Open-Source-Videoüberwachung, die auf dem eigenen Rechner per KI erkennt, was eine Kamera sieht: Person, Auto, Katze, Paket. Das funktioniert herstellerunabhängig mit jeder Kamera, die einen RTSP-Stream liefert, und ohne Cloud. Im Forum tauchte Frigate schon mehrfach auf, eingebunden aber immer nur über rohe MQTT-Topics und Handarbeit. Ein fertiges Modul habe ich im Module Store nicht gefunden.

Worum geht es?

FrigateHub holt Frigates Erkennungen als Variablen nach Symcon, zeigt die Kameras als Kachel und gibt Frigate-Schalter zurück in die Hand von Symcon. Damit lassen sich Abläufe bauen, die eine reine Bewegungserkennung nicht hergibt: Licht in der Einfahrt nur bei einer Person, nicht bei jedem Ast im Wind. Eine Meldung mit Bild, wenn jemand vor der Tür steht. Aufnahme an, sobald alle aus dem Haus sind.

Drei Instanzen:

  • Frigate-Konfigurator: liest die Kameras aus Frigate und legt sie mit einem Klick fertig eingerichtet an
  • Frigate-Kamera: eine Kamera mit allen Erkennungen, Schaltern, Bildern – und zugleich eine Kachel
  • Frigate-Server: Zustand von Frigate selbst und eine Übersichtskachel aller Kameras

Erkennungen und Schalter

  • Variablen: Bewegung, Alarm und Erkennung (nach Frigates Einstufung), Anzahl je Objektklasse und je Zone, erkannte Geräusche, letzte Ereignisse im Klartext („29.10.2026 18:06:00 – Person in Eingangsbereich“).
  • Gesichter, Kennzeichen, KI: Hat man in Frigate Gesichts- oder Kennzeichenerkennung bzw. die KI-Beschreibung eingerichtet, kommen „Erkannte Person“, „Kennzeichen“, die KI-Beschreibung eines Ereignisses und ihre Einschätzung (unauffällig/verdächtig/kritisch) als Variablen dazu.
  • Schnappschuss als Medienobjekt in voller Kameraauflösung.
  • Frigate aus Symcon schalten: Erkennung, Aufnahme, Schnappschüsse, Bewegungserkennung, einzelne Masken und Zonen, Bewegungsschwelle, Birdseye, PTZ-Verfolgung und mehr. Die Variable übernimmt einen Wert erst, wenn Frigate ihn bestätigt.

Die Kachel

  • Livebild oder echtes Livevideo mit Ton (WebRTC über Frigates eingebautes go2rtc, im Heimnetz). Ohne go2rtc-Stream oder unterwegs zeigt die Kachel das Livebild im eingestellten Takt.
  • Ereignisleiste mit Vorschaubild; ein Tipp zeigt Schnappschuss und Clip. Ungesehene Ereignisse sind markiert, ein Ereignis lässt sich dauerhaft behalten oder als Export in Frigate speichern.
  • Archiv: alle Ereignisse eines Tages, filterbar nach Alarm, Erkennung, Objekt oder „noch nicht gesehen“, dazu die Aufnahme ab einer Uhrzeit.
  • Warnhinweise, wenn in Frigate Erkennung oder Aufnahme ausgeschaltet ist, und ein Steuerkreuz für schwenkbare Kameras.
  • Für IPSView gibt es dieselbe Oberfläche als eigenständige Seite.

Meldungen, Server und Zusammenspiel

  • Meldung bei Alarm an Kachel-Visualisierung oder WebFront (Antippen öffnet die Kamera) und auf Wunsch als E-Mail mit Kamerabild. Mit FRIG_MeldungMitSchnappschuss() lässt sich dieselbe Meldung in Alarmanlagen, Ereignissen oder Skripten als Aktion eintragen.
  • Frigate-Server: erreichbar, Version und ob es eine neuere gibt, freier Speicher für Aufnahmen, gestörte Kameras im Klartext; die Auslastung steht im Formular. Frigate lässt sich von dort neu starten.
  • OpenHomeAlarm (die Alarmanlage von Burki24): FrigateHub meldet Frigate-Alarme als bestätigte Ereignisse an dessen neue Schnittstelle und schaltet beim Scharfschalten Aufnahme und Erkennung ein. Beides ist optional; die Module finden sich von selbst und setzen sich nicht gegenseitig voraus. Danke an Burkhard für die schnelle und angenehme Abstimmung!
RequestAction($variablenID, false);                      // z. B. Aufnahme ausschalten
FRIG_MeldungMitSchnappschuss($id, "Klingel", true);       // Meldung mit aktuellem Kamerabild
FRIG_ZustandAnfordern($id);                               // Schalter und Zonen neu aus Frigate holen

Voraussetzungen

  • IP-Symcon ab 9.0
  • Frigate, das per MQTT an Symcon sendet (Frigate-Konfiguration mqtt: mit der Adresse des Symcon-Servers). Am einfachsten über Symcons eingebauten MQTT-Server, ein vorhandener Broker geht über einen MQTT-Client.
  • Für Konfigurator, Abgleich, Bilder, Kachel und Archiv: Frigates API, entweder Port 5000 (ohne Anmeldung, muss im Docker-Aufruf freigegeben sein) oder Port 8971 mit Frigate-Benutzer. Das Passwort wird nicht gespeichert.
  • Für Livevideo: ein go2rtc-Stream der Kamera in Frigate und Port 8555 (TCP/UDP) freigegeben. Die genaue Einstellung steht in der Beschreibung des Moduls.

Stand der Erprobung

Getestet habe ich an meiner eigenen Anlage: Frigate 0.18.2 im Docker auf einem Intel N100 mit OpenVINO, eine Kamera an der Haustür, Symcon 9.0 auf demselben Rechner mit dem eingebauten MQTT-Server. Dort laufen Erkennungen, Zonen, Schalter, Schnappschüsse, Kachel mit Livevideo, Archiv, Server-Übersicht, Meldungen per Kachel-Push und E-Mail mit Bild, die Anmeldung über Port 8971 und das Zusammenspiel mit OpenHomeAlarm. Dazu kommen Prüfstände mit rund 570 Prüfungen, die unter anderem die echten MQTT-Nachrichten meiner Frigate-Instanz nachspielen.

Was ich mangels Gelegenheit noch nicht testen konnte:

  • mehrere Kameras gleichzeitig
  • schwenkbare Kameras (PTZ) und Geräuscherkennung
  • Gesichter, Kennzeichen und KI-Beschreibungen mit echten Daten
  • ein externer Broker (Mosquitto o. ä.) über Symcons MQTT-Client
  • ältere Frigate-Versionen (0.14 bis 0.17)
  • die Kachel in Safari und in der Symcon-App

Wer Frigate im Einsatz hat, hilft mir mit einer kurzen Rückmeldung sehr: Frigate-Version, Anzahl Kameras und was angekommen ist bzw. was fehlt. Das Panel „Empfangene Nachrichten“ in der Kamera-Instanz zeigt, was Frigate tatsächlich schickt; ein Ausschnitt daraus spart oft eine Rückfrage.

Installation

Über den Module Store: In der Verwaltungskonsole nach FrigateHub suchen, das Modul steht im Bereich Beta, ab Symcon 9.0.

  1. Instanz Frigate-Konfigurator unter dem MQTT-Server anlegen, an den Frigate sendet.
  2. Frigate-Adresse eintragen, z. B. http://192.168.1.20:5000 oder https://192.168.1.20:8971 (dann Benutzer und Passwort eintragen und „Anmelden“).
  3. In der Liste die Kameras und den Frigate-Server auswählen und „Erstellen“. Die Kamera-Instanz lässt sich direkt als Kachel in die Visualisierung legen.

Die ausführliche Beschreibung ist im Module Store beim Modul verlinkt.

Hinweis

Frigate ist ein Open-Source-Projekt von Frigate, Inc.; FrigateHub ist kein offizielles Frigate-Projekt.

Lizenz

PolyForm Noncommercial 1.0.0: Private Nutzung ist frei, gewerbliche Nutzung braucht eine gesonderte Lizenz. Wer das Projekt unterstützen möchte: paypal.me/DietmarGureth

Ich bin gespannt, was eure Kameras so alles erkennen.

Viele Grüße Dietmar