Blue Iris Smart-Home-Integration, kostenlos und Open Source
Blue-Iris-Videoüberwachung lokal: Bilder, Bewegung, KI-Alarme, Profile, PTZ.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration verbindet Gladys mit Blue Iris, der Videoüberwachungssoftware für Windows, über ihre lokale JSON-Schnittstelle (die ihrer eigenen Weboberfläche). Nichts läuft über eine Cloud.
- ein Gerät pro Kamera: ihr Bild, ob sie online ist, Bewegung sieht oder ausgelöst ist, und die von der KI von Blue Iris bestätigte Person oder das Fahrzeug, wenn du eine verwendest;
- ein Blue-Iris-Servergerät: aktives Profil, Scharfschaltsignal (grün, gelb, rot), CPU-Last und Speicher der Aufnahmen;
- Befehle: Profil wechseln, scharf schalten, eine Kamera auslösen, eine PTZ-Kamera bewegen oder auf eine gespeicherte Position schicken. Unscharfschalten ist standardmäßig aus, wie bei einer Alarmanlage;
- ein Szenenauslöser „Alarm einer Blue-Iris-Kamera“ mit dem, was erkannt wurde, und ein Dashboard-Widget.
Developed without the hardware: feedback welcome. Diese Integration wurde nach der Dokumentation der JSON-Schnittstelle von Blue Iris und anderen Integrationen geschrieben, ohne Blue-Iris-Server zur Hand. Sag in den Issues, was funktioniert und was nicht.
Diese Integration ist nicht mit Perspective Software verbunden, dem Hersteller von Blue Iris.
Voraussetzungen
- Blue Iris 5 oder neuer, mit laufendem Webserver (Einstellungen → Webserver), von Gladys aus erreichbar (Standardport 81).
- Ein eigener Blue-Iris-Benutzer für Gladys (Einstellungen → Benutzer), mit Passwort:
- ein normaler Benutzer (kein Administrator) reicht zum Lesen der Kameras, des Profils und der Alarme;
- erlaube ihm Profilwechsel, um aus Gladys scharf zu schalten und das Profil zu wechseln;
- erlaube ihm PTZ, um die Kameras zu bewegen;
- eine Kamera auslösen erfordert einen Administrator in Blue Iris.
- Wenn der Webserver den Zugriff einschränkt („Non-LAN only“, automatische Sperre), ist die Adresse von Gladys im lokalen Netz: nichts zu ändern. Blue Iris kann eine Adresse nach einigen falschen Passwörtern sperren; die Integration stoppt bei der ersten Ablehnung.
Konfiguration
In Gladys Integrationen → Blue Iris → Konfiguration:
| Einstellung | Aufgabe |
|---|---|
| Adresse des Servers | IP-Adresse oder Name des Windows-PCs, auf dem Blue Iris läuft, z. B. 192.168.1.20. |
| Port des Webservers | 81, außer du hast ihn in Blue Iris geändert. Ein in der Adresse angegebener Port hat Vorrang. |
| HTTPS | Nur wenn der Webserver von Blue Iris auf diesem Port HTTPS liefert. Sein Zertifikat wird nicht geprüft. |
| Benutzername / Passwort | Der eigene Blue-Iris-Benutzer. Das Passwort wird nur an Blue Iris gesendet. |
| Aktualisierung | Wie oft Blue Iris gelesen wird (5 s bis 1 min, Standard 10 s): Bewegung, Auslöser und Alarme werden in diesem Takt erkannt. |
| Kamerabilder | Wie oft das Bild jeder hinzugefügten Kamera erneuert wird (oder „Nur bei Alarmen“). Ein Alarm sendet immer ein neues. |
| Gewähltes Profil halten | An (Standard): Ein aus Gladys gewähltes Profil bleibt, der Zeitplan von Blue Iris ändert es nicht mehr. Aus: bis zu seinem nächsten Wechsel. |
| Unscharfschalten aus Gladys erlauben | Standardmäßig aus. Siehe unten. |
| Weitere unscharfe Profile | Profile, in denen deine Kameras nicht überwachen (z. B. Zuhause), per Name oder Nummer, durch Kommas getrennt. |
| Sprache der Namen | Sprache der Funktionsnamen und der Texte für Szenen. Die Namen werden beim Hinzufügen festgelegt. |
Dann Verbindung testen: Der Bericht nennt den Server, die Anzahl der Kameras, das aktive Profil und die Rechte des Benutzers. Öffne den Tab Entdecken und füge den Server und die gewünschten Kameras hinzu.
Scharf- und Unscharfschalten. Scharfschalten (grünes Signal, jedes überwachende Profil) ist immer erlaubt. Unscharfschalten — das rote Signal, Profil 0 „Inactive“ (in dem Blue-Iris-Kameras nicht auslösen) oder ein unter Weitere unscharfe Profile genanntes Profil — wird abgelehnt, bis du Unscharfschalten aus Gladys erlauben einschaltest: Ein versehentliches Unscharfschalten macht die Kameras blind. Unscharfschalten ist nie ein Schalter: Weder ein Sprachassistent noch ein Dashboard-Schalter kann es aus Versehen tun.
Geräte
Blue-Iris-Server
| Funktion | Bedeutung |
|---|---|
| Online | Blue Iris antwortet. |
| Profil | Das aktive Profil (0 bis 7, mit den Namen aus Blue Iris). Ein Befehl: Wähle ein anderes. |
| Scharfschaltung | Scharf (grün), Wird scharf (gelb) oder Unscharf (rot). Ein Befehl: Grün schaltet scharf, Rot unscharf, wenn erlaubt. |
| CPU-Last | CPU-Last des Servers, in %. |
| Belegter Speicher | Füllstand des Aufnahmespeichers von Blue Iris, in %. |
| Freier Speicher | Freier Platz der Aufnahmelaufwerke, in GB. |
Profil und Signal sind nur lesbar für einen Benutzer, der keine Profile wechseln darf.
Kameras
Ein Gerät pro Kamera von Blue Iris (Gruppen und die Ansicht „alle Kameras“ werden ausgelassen), benannt wie in Blue Iris:
| Funktion | Bedeutung |
|---|---|
| Bild | Das Kamerabild, in der Kamerabox des Dashboards. |
| Online | Die Kamera ist aktiviert und empfängt Video. |
| Bewegung | Blue Iris sieht Bewegung. |
| Ausgelöst | Die Kamera ist ausgelöst (Aufnahme, Alarme nach ihren Einstellungen). |
| Person | Ein Alarm hat eine Person bestätigt (KI). Erscheint, sobald Blue Iris eine gemeldet hat. |
| Fahrzeug | Ein Alarm hat ein Fahrzeug bestätigt (KI). Erscheint, sobald Blue Iris eines gemeldet hat. |
| Schwenken, Neigen, Zoom | PTZ-Kameras: die Pfeile und der Zoom der Kamerabox des Dashboards. Eine Bewegung stoppt nach 2 Sekunden von selbst. |
| Gespeicherte Position | PTZ-Kameras mit Positionen: auf eine in Blue Iris gespeicherte Position fahren. |
Person und Fahrzeug bleiben mindestens 30 Sekunden nach dem Alarm an, dann solange die Kamera
ausgelöst ist. Beide erscheinen im Tab Entdecken („Aktualisieren“), wenn die KI von Blue Iris zum ersten
Mal eines meldet; dafür werden beim Start die Alarme der letzten 24 Stunden gelesen. Die Bezeichnungen
der KI (CodeProject.AI, DeepStack…) werden aus dem Memo des Alarms gelesen: person, car, truck,
bus, motorcycle, bicycle…
Dashboard-Widget
Das Widget Blue Iris zeigt für alle Kameras oder die in seinen Einstellungen gewählte:
- das aktive Profil, Scharf / Wird scharf / Unscharf, die Kameras online und die Alarme über 24 Stunden;
- die letzten Alarme mit dem, was erkannt wurde, und dem Bild aus diesem Moment;
- eine Taste Scharf schalten, solange nicht scharf; Unscharf nur, wenn in der Konfiguration erlaubt, mit Bestätigung; Auslösen für die gewählte Kamera.
Szenenauslöser
Alarm einer Blue-Iris-Kamera: Blue Iris hat einen Alarm einer Kamera ausgelöst. Filter: die
Kamera und Was erkannt wurde: Person, Fahrzeug, Tier, Bewegung, Geräusch, Externer Auslöser,
Anderer Alarm (das Aussagekräftigste zuerst: Ein Alarm mit Person und Bewegung ist „Person“). Das
Kamerabild ist aktuell, wenn die Szene startet. Variablen: Name der Kamera, Was erkannt
wurde, KI-Bezeichnungen (das Memo von Blue Iris, z. B. person:87%).
Nur die Alarme, die Blue Iris behält (nicht die von seiner KI verworfenen), starten eine Szene, ein Ereignis pro Alarm. Wenn der Benutzer die Alarme nicht lesen darf, wird ein Alarm trotzdem erkannt (als „Anderer Alarm“), anhand der Zeit des letzten Alarms der Kamera.
Szenenaktionen
- Blue-Iris-Profil wechseln: per Name (
Away) oder Nummer (1). Ein unscharfes Profil nur, wenn erlaubt. - Blue Iris scharf oder unscharf schalten: Grün schaltet scharf; Rot unscharf nur, wenn erlaubt.
- Blue-Iris-Kamera auslösen: wie ihre Taste „Jetzt auslösen“ (Administrator in Blue Iris).
- Kamerabild aktualisieren: nimmt ein neues Bild für Gladys auf, um es danach in einer Nachricht zu senden.
Szenenbeispiele
- Beim Verlassen des Hauses: Wenn die Alarmanlage des Hauses scharf ist → Blue-Iris-Profil
wechseln auf
Away. - Nachts jemand an der Tür: Alarm einer Blue-Iris-Kamera, Kamera „Haustür“, Was erkannt wurde = Person, zwischen 22 und 6 Uhr → das Licht am Eingang einschalten, dann das Kamerabild in einer Telegram-Nachricht senden.
- Das Tor beobachten: Ein Öffnungssensor öffnet → Blue-Iris-Kamera auslösen „Tor“, dann die PTZ-Kamera auf ihre gespeicherte Position „Tor“ fahren.
Aktualisierung und Last
Blue Iris ist ein lokaler Server ohne Kontingent: Die Integration liest status und camlist im
Takt der Aktualisierung (zwei kleine Anfragen) und die Alarmliste nur für eine Kamera mit neuem
Alarm. Höchstens zwei Anfragen laufen gleichzeitig. Bilder werden von Blue Iris verkleinert angefordert
(1280 px, dann kleiner, wenn das Bild über den 150 KB liegt, die Gladys annimmt): Im Container wird
nichts dekodiert. Ein unveränderter Wert wird alle 6 Stunden erneut gesendet, damit das Dashboard nie
„kein aktueller Wert“ anzeigt.
Fehlerbehebung
- „Blue Iris antwortet nicht“: Prüfe Adresse, Port, ob der Webserver von Blue Iris läuft und ob die Windows-Firewall Gladys durchlässt.
- „Passwort abgelehnt: angehalten, damit Blue Iris Gladys nicht sperrt“: Korrigiere Benutzername oder Passwort, dann Verbindung testen (ein weiterer Versuch). Prüfe in Blue Iris, dass die Adresse von Gladys nicht gesperrt ist.
- „Keine JSON-Schnittstelle von Blue Iris unter dieser Adresse“: falscher Port, oder ein anderer Webserver antwortet.
- „Dieser Blue-Iris-Benutzer darf das nicht“: Gib ihm das Recht in Blue Iris (Profile wechseln, PTZ, Administrator zum Auslösen).
- Unscharfschalten abgelehnt: absichtlich, siehe „Scharf- und Unscharfschalten“.
- Keine Funktion Person / Fahrzeug: Die KI von Blue Iris hat noch keines gemeldet; sie erscheint beim ersten in Entdecken („Aktualisieren“).
- Für Details setze
LOG_LEVEL=debugfür die Integration: Dann wird jeder Alarm und jedes Lesen protokolliert.
Grenzen
- Ein Blue-Iris-Server pro Integration.
- Kein Live-Videostream (Gladys zeigt Bilder), keine Wiedergabe von Aufnahmen, keine DIO-Ausgänge, kein Wechsel des Zeitplans.
- Bewegung und Alarme werden im Takt der Aktualisierung erkannt (Standard 10 s), nicht sofort: Blue Iris sendet seine Ereignisse per MQTT oder Webaufruf, die die Sandbox von Gladys hier nicht empfangen kann.
- Gelb ist ein Übergang von Blue Iris (Scharfschaltverzögerung): Es wird angezeigt, nie gesendet.
- Funktionsnamen werden beim Hinzufügen eines Geräts festgelegt; Kameragruppen sind keine Geräte.
- Ohne die Hardware entwickelt: Rückmeldungen sind willkommen (Developed without the hardware: feedback welcome).
Konfigurationseinstellungen
Diese Einstellungen fragt Blue Iris in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Blue-Iris-Server | section | Nein | Der Webserver von Blue Iris muss laufen (Einstellungen → Webserver). Lege einen eigenen Blue-Iris-Benutzer für Gladys an: Ein normaler Benutzer reicht zum Lesen; erlaube ihm Profilwechsel, um aus Gladys scharf zu schalten. Nichts läuft über eine Cloud. |
| Adresse des Servers | string | Ja | IP-Adresse oder Name des Windows-PCs, auf dem Blue Iris läuft. |
| Port des Webservers | number | Nein | 81, außer du hast ihn in Blue Iris geändert. |
| HTTPS | boolean | Nein | Nur wenn der Webserver von Blue Iris auf diesem Port HTTPS liefert. Sein Zertifikat wird nicht geprüft. |
| Benutzername | string | Ja | |
| Passwort | secret | Ja | Wird nur an Blue Iris gesendet. Blue Iris kann eine Adresse nach Fehlversuchen sperren: Die Integration stoppt bei der ersten Ablehnung. |
| Aktualisierung | select | Nein | Wie oft Blue Iris gelesen wird: Bewegung, Auslöser und Alarme werden in diesem Takt erkannt. |
| Kamerabilder | select | Nein | Wie oft das Bild jeder hinzugefügten Kamera erneuert wird. Ein Alarm sendet immer ein neues. |
| Scharf- und Unscharfschalten | section | Nein | Scharfschalten (grünes Signal, jedes aktive Profil) ist immer erlaubt. Unscharfschalten (rotes Signal, Profil 0 „Inactive“ oder die unten genannten Profile) ist standardmäßig aus, wie bei einer Alarmanlage. |
| Gewähltes Profil halten | boolean | Nein | Ein aus Gladys gewähltes Profil bleibt bis zur nächsten Wahl, der Zeitplan von Blue Iris ändert es nicht mehr. Aus: bis zum nächsten Wechsel des Zeitplans. |
| Unscharfschalten aus Gladys erlauben | boolean | Nein | Standardmäßig aus: Ein versehentliches Unscharfschalten (eine Szene, ein Tippen) macht die Kameras blind. |
| Weitere unscharfe Profile | string | Nein | Profile, in denen deine Kameras nicht überwachen (z. B. Zuhause), per Name oder Nummer, durch Kommas getrennt. Profil 0 zählt immer. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und der Texte für Szenen. Die Namen werden beim Hinzufügen festgelegt. |
So installierst du Blue Iris in Gladys
- Öffne in Gladys Integrationen: Blue Iris erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-blue-iris: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-blue-iris.
Blue Iris 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
Blue Iris 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