Viseron Smart-Home-Integration, kostenlos und Open Source
Viseron-Kameras: Bilder, Bewegung, erkannte Objekte (Person, Auto…), Aufnahme, lokal.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Bringt die Kameras eines Viseron-Servers (der selbst gehostete Netzwerk-Videorekorder mit Objekterkennung) in Gladys: ihr Bild, die erkannte Bewegung, die Objekte, die Viseron verfolgt (Person, Auto, Hund…), die laufende Aufnahme und ob sie online sind. Die Live-Ereignisse von Viseron starten Szenen, mit dem Bild des Moments, das dir eine Szene schicken kann. Szenen können außerdem eine Aufnahme starten oder beenden.
Getestet gegen einen echten Viseron-Server in Docker (3.7.0, CPU, darknet-Objekterkennung) mit simulierten Netzwerkkameras, noch nicht in einer laufenden Installation mit echten Kameras: Feedback ist willkommen auf GitHub oder im Gladys-Forum.
Was du brauchst
- Gladys 5.1 oder neuer.
- Viseron 3.7 oder neuer, von Gladys über seinen Web-Port erreichbar (standardmäßig 8888).
- Die Kameras bereits in Viseron eingerichtet (Komponente
ffmpegodergstreamer), mit einem Bewegungsmelder und einem Objektdetektor, wenn du diese Funktionen willst. - Wenn die Authentifizierung in Viseron aktiv ist (
webserver: auth:), ein Viseron-Benutzer für Gladys. Die Rolle read reicht, um die Kameras zu verfolgen; mit der Rolle write kann Gladys auch Aufnahmen starten.
Installation
- Öffne in Gladys Integrationen, suche Viseron und installiere es.
- Fülle im Tab Konfiguration aus:
- Viseron-Adresse: die Adresse des Rechners, auf dem Viseron läuft, z. B.
192.168.1.20. Ohne Port wird 8888 verwendet; füge:porthinzu, wenn er geändert wurde, oderhttps://hinter einem Reverse-Proxy. - Benutzername und Passwort: nur wenn die Authentifizierung in Viseron aktiv ist. Sonst leer lassen.
- Bildaktualisierung: wie oft das Bild jeder Kamera an Gladys gesendet wird (von 10 Sekunden bis 15 Minuten, standardmäßig 1 Minute). Bewegung oder ein erkanntes Objekt sendet sofort eines.
- Sprache der Namen: die Sprache der Funktionsnamen, die beim Hinzufügen einer Kamera vergeben werden.
- Viseron-Adresse: die Adresse des Rechners, auf dem Viseron läuft, z. B.
- Speichere und öffne dann den Tab Entdecken: ein Gerät pro Kamera. Füge die gewünschten hinzu.
- Verbindung prüfen zeigt, was die Integration liest: die Viseron-Version, ob Live-Ereignisse ankommen, jede Kamera, ob sie online ist, aufnimmt und welche Objekte sie verfolgt.
Die Gladys-Geräte
Jede Viseron-Kamera wird zu einer Gladys-Kamera, benannt wie in Viseron, mit:
| Funktion | Was es ist |
|---|---|
| Bild | Das Kamerabild, im gewählten Takt und sofort bei Bewegung oder Objekt gesendet. |
| Bewegung | 1, solange der Bewegungsmelder von Viseron Bewegung sieht, sonst 0. |
| Objekt erkannt | 1, solange ein von Viseron verfolgtes Objekt im Bild ist, sonst 0. |
| Person erkannt, … | Eine pro Label, das Viseron auf der Kamera verfolgt (Person, Auto, Hund…). |
| Aufnahme | 1 während einer Aufnahme. Ein Schalter: startet oder beendet eine Aufnahme. |
Die Funktionen folgen der Viseron-Konfiguration: Eine Kamera ohne Bewegungsmelder hat keine Bewegung. Ein später in Viseron hinzugefügtes Label erscheint nach Aktualisieren im Tab Entdecken. Eine Kamera, deren Stream verloren ist oder die in Viseron gestoppt ist, erscheint in Gladys als nicht erreichbar.
Mit Version 1.0.x hinzugefügte Kameras: Diese Kameras hatten eine Funktion Online vom Gladys-Typ „Kamera aktiviert", den Gladys 5.2 als Privatsphäre-Modus der Kamera nutzt (bei 0 verweigert Gladys ihre Bilder). Öffne den Tab Entdecken der Integration und klicke bei jeder Kamera auf Aktualisieren: Die Funktion verschwindet. Bis dahin setzt die Integration sie beim Start einmal auf 1, damit die Bilder weiter ankommen.
Dashboard-Widget
Viseron-Kamera zeigt das Bild einer Kamera, Bewegung, die sichtbaren Objekte (z. B. „Hund, Person“), Aufnahme und Online-Status, und zwei Schaltflächen: Aufnehmen (oder Aufnahme beenden) und Neues Bild.
Szenen
Auslöser
- Viseron: Objekt erkannt: Viseron beginnt, ein verfolgtes Objekt zu sehen. Filter: die Kamera
(leer = alle), das Objekt (Label, z. B.
person) und die Zone (leer = alle), geschrieben wie in der Viseron-Konfiguration. Variablen: der Kameraname, das Objekt, die Zone (leer für das ganze Bild) und die Konfidenz in %. Das Bild des Moments wird zuerst an Gladys gesendet. Ein Objekt, das sowohl im ganzen Bild als auch in einer Zone verfolgt wird, löst für beide einmal aus: Filtere auf die Zone, um nur eines zu behalten. - Viseron: Bewegung erkannt: Der Bewegungsmelder einer Kamera beginnt, Bewegung zu sehen. Filter: die Kamera. Variable: der Kameraname. Das Bild des Moments wird zuerst gesendet.
- Viseron: Kamera offline: Eine in Viseron aktive Kamera verliert seit 30 Sekunden ihren Stream, oder Viseron selbst antwortet nicht mehr. Nicht für eine in Viseron gestoppte Kamera.
Aktionen
- Viseron: aufnehmen: Starten startet eine manuelle Aufnahme auf einer Kamera, Beenden beendet sie. Viseron lehnt sie für eine Kamera ab, die offline ist, und mit Authentifizierung für einen Benutzer ohne die Rolle write.
Die Kernaktion Kamerabild senden sendet das letzte Bild einer Kamera: Direkt nach Viseron: Objekt erkannt oder Viseron: Bewegung erkannt ist es das Bild dieses Moments.
Szenenideen
- Jemand an der Tür: Viseron: Objekt erkannt, Kamera „Eingang“, Objekt
person→ Kamerabild senden dieser Kamera an dein Handy, mit{{triggerEvent.data.score}}% im Text. - Auto in der Einfahrt nachts: Viseron: Objekt erkannt, Objekt
car, Zonedriveway→ das Außenlicht fünf Minuten einschalten. - Tür geöffnet, während du weg bist: Ein Öffnungssensor öffnet und niemand ist zu Hause → Viseron: aufnehmen, Starten, auf der Flurkamera; Beenden zwei Minuten später.
- Kamera verloren: Viseron: Kamera offline → eine Nachricht mit dem Kameranamen senden.
Fehlerbehebung
- „Viseron antwortet unter dieser Adresse nicht“: Öffne
http://<Adresse>:8888in einem Browser. Prüfe den Port und dass keine Firewall Gladys blockiert. - „Etwas antwortet, aber nicht wie Viseron“: Adresse oder Port führen zu einem anderen Dienst. Gib die Adresse von Viseron ohne Seitenpfad ein.
- „Viseron verlangt eine Anmeldung oder lehnt Benutzername oder Passwort ab“: Die Authentifizierung ist in Viseron aktiv. Gib einen Viseron-Benutzer ein (kein persönliches Zugriffstoken) oder prüfe das Passwort.
- Keine Objekt- oder Bewegungsfunktion: Die Kamera hat in der Viseron-Konfiguration keinen Objektdetektor oder Bewegungsmelder, oder Viseron hat ihn nicht gestartet (siehe Viseron-Protokolle).
- „Keine Live-Ereignisse“ in Verbindung prüfen: Der WebSocket von Viseron lässt sich nicht öffnen
(ein Reverse-Proxy muss WebSockets auf
/websocketdurchlassen). Die Zustände werden dann nur einmal pro Minute gelesen, und außer Kamera offline löst kein Auslöser aus. - Mehr Details: die Protokolle der Integration (Integrationen → Viseron → Protokolle); setze
LOG_LEVELaufdebug, um jede Anfrage zu sehen.
Grenzen
- Kein Live-Video: Gladys zeigt Bilder, im gewählten Takt gesendet (Gladys behält höchstens 12 Bilder pro Minute und Kamera). Live-Stream und Aufnahmen schaust du in Viseron an.
- Labels und Zonen werden so gefiltert, wie sie in Viseron geschrieben sind: Die Szenenfilter vergleichen nur Text.
- Höchstens 12 Labels pro Kamera werden zu Funktionen.
- Vergangene Aufnahmen, Gesichts- und Kennzeichenerkennung, PTZ sowie das Starten oder Stoppen von Kameras sind nicht abgedeckt.
- Ein Viseron-Server pro Integration.
- Getestet mit Viseron 3.7.0 in Docker und simulierten Kameras, ohne echte Installation: Feedback ist willkommen.
Diese Integration ist weder mit Viseron noch mit seinen Autoren verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Viseron in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Viseron-Server | section | Nein | Viseron, der selbst gehostete Videorekorder mit Objekterkennung. Gib seine Adresse ein (standardmäßig Port 8888) und öffne dann den Tab „Entdecken“: ein Gerät pro Kamera. |
| Viseron-Adresse | string | Ja | Ohne Port wird 8888 verwendet. Füge https:// hinter einem Reverse-Proxy hinzu. |
| Benutzername | string | Nein | Nur wenn die Authentifizierung in Viseron aktiv ist (webserver: auth). Ein Benutzer mit Schreibrolle kann auch Aufnahmen starten. |
| Passwort | secret | Nein | |
| Bildaktualisierung | select | Nein | Wie oft das Bild jeder Kamera an Gladys gesendet wird. Bewegung oder ein erkanntes Objekt sendet sofort eines. |
| Sprache der Namen | select | Nein | Namen, die den Funktionen beim Hinzufügen einer Kamera gegeben werden (Bewegung, Person erkannt…). |
So installierst du Viseron in Gladys
- Öffne in Gladys Integrationen: Viseron erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-viseron:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-viseron.
Viseron benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Viseron ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation