Agent DVR

Agent-DVR-Adapter für ioBroker

Verbindet ioBroker mit AgentDVR : Erkennt automatisch alle Kameras, spiegelt jede Geräteeigenschaft als Datenpunkte wider, bietet Schaltflächen für alle gängigen Befehle (Aufnahme, Scharfschalten, PTZ, …), liefert Push-getriggerte Galerie-Updates bei neuen Aufnahmen, generiert ein responsives HTML-Galerie-Widget pro Kamera und beinhaltet ein integriertes Live-Dashboard mit Stream-Auswahl pro Kamera (MJPEG, MP4/FLV mit Audio oder go2rtc WebRTC).

Anforderungen

• ioBroker mitiobroker.web Adapter
• AgentDVR ≥ 7.8.0.0 – frühere Versionen weisen einen Fehler aufstreamFile.cgi Ein Endpunkt (fehlerhafte Chunked-Codierung, falscher MIME-Typ) verhindert die Wiedergabe von Aufnahmen im integrierten Dashboard. Der Entwickler hat bestätigt, dass die Korrektur in Version 7.8.0.0 enthalten ist.

Merkmale

• Automatische Erkennung aller AgentDVR-Kameras beim Start (Mikrofone ausgenommen)
• Alle Geräteeigenschaften werden als Datenpunkte abgebildet (aus der API übernommen).
• Gerätespezifische Steuerungstasten: Aufnahme, Schnappschuss, Erkennung, Aktivierungs-/Deaktivierungsalarme, Ein-/Ausschalten, Objekterkennung, Zeitplan-Ein-/Ausschalten, Detektor-Ein-/Ausschalten, Empfindlichkeit (Min./Max./Verstärkung), Datenbereinigung, …
• Systemtasten: Scharfschalten, Unscharfschalten, Alles ein/aus, Nachladen, Speicherverwaltung, Neustart, …
• Profilauswahl – beschreibbares Dropdown-Menü, das das aktuelle AgentDVR-Profil anzeigt (Zuhause / Abwesend / Nachts / Benutzerdefiniert)
• Snapshot als Base64 —snapshot_b64 Status pro Kamera, über eine Schaltfläche beschreibbar oder bei jedem Abfragezyklus automatisch aktualisiert
• PTZ-Steuerung mit Halte-zum-Bewegen-Tasten
• Stream-URLs pro Kamera (Schnappschuss, Foto, MJPEG, MP4)
• Webhook-Endpunkt für Echtzeitaktualisierungen – rufen Sie ihn aus einer AgentDVR-Aktion auf, um eine sofortige vollständige Abfrage auszulösen.
• HTML-Aufnahmegalerie-Widget pro Kamera (widget_recordings ) und Live-Kachel mit einer Kamera (widget_live — reiner HTML/CSS- oder vollständiger JS-Modus mit Such- und Tag-Filter
• Übersichts-Widget, das alle Kameras in einem HTML-Zustand kombiniert
• Integriertes Live-Dashboard beihttp://<iobroker>:<webport>/agent-dvr.0/ — keine zusätzliche App erforderlich:
  • Auswahl des Streams pro Kamera: MJPEG, MP4/FLV mit Audio oder go2rtc WebRTC/MSE
  • Schaltfläche für den Kamerafilter in der Kopfzeile (Trichtersymbol) – öffnet ein Popup mit Kontrollkästchen für jede Kamera; ein Badge zeigt an, wie viele Kameras ausgeblendet sind; der Status wird im localStorage gespeichert.
  • Bewegungs- und Alarmindikatoren in Echtzeit (gelber/oranger Kachelrand) über Socket.io
  • Vollbildansicht mit PTZ-Overlay, Aufnahmefunktion, Stummschaltung und nativer Browser-Vollbildschaltfläche; Kopfzeile wird automatisch ausgeblendet
  • Registerkarte „Aufnahmen“ mit Raster-, Zeitleisten- und Ereignisprotokollansicht, Suche, ausklappbarem Tag-Filter und Videoplayer mit Zurück-/Weiter-Navigation
  • Aufnahmen direkt aus dem Videoplayer-Fenster löschen (erfordert AgentDVR v7.7.8.0+)
  • Anzeigeeinstellungen für Aufnahmen — Das Zahnradsymbol ⚙ in der Auswahl-/Löschleiste passt die Spaltenbreite des Rasters, die maximale Anzahl der angezeigten Aufnahmen und die Sichtbarkeit des Abzeichens an (wird im lokalen Speicher gespeichert).
  • Die Kamerafarben werden von AgentDVR ausgelesen und auf die Zeitleistenbalken und Aufzeichnungspunkte angewendet.
  • PTZ-Voreinstellungen – Navigieren Sie über das PTZ-Overlay zu gespeicherten Voreinstellungen (erfordert AgentDVR v7.7.8.0+)
  • Die Statusleiste zeigt die Anzahl der Kameras in der Live-Ansicht und die Anzahl der Aufnahmen/Ereignisse in der Aufnahmeansicht an.
  • Automatische Wiederverbindung für alle Stream-Typen nach Netzwerkunterbrechung oder Tab-Wechsel
  • Vollständig farblich anpassbar über Adapterkonfiguration

Konfiguration

Registerkarte: Verbindung

Registerkarte: Funktionen

Bedienelemente

Veranstaltungen

Anzeige

Proxy

Debuggen

Registerkarte: Dashboard

Standardansicht

Kameraraster

Strom

Farbthema – 7 Farbauswahlmöglichkeiten passend zu Ihrer Benutzeroberfläche:

Stream-Zuweisung

Hier weisen Sie jeder Kamera einzeln eine Streamquelle zu. Die Dropdown-Liste zeigt alle von AgentDVR erkannten Kameras an (Mikrofone sind ausgeschlossen).

Die go2rtc-Streamnamen werden automatisch vom go2rtc-Server abgerufen, sobald die Admin-Oberfläche geöffnet ist. Kann der Browser go2rtc nicht direkt erreichen (z. B. bei gemischten Inhalten über HTTPS), ruft der Adapter sie serverseitig als Fallback ab.

go2rtc-URL (nur sichtbar, wenn mindestens eine Kamera einen go2rtc-Stream verwendet)

Hinweis: go2rtc muss die Streams bereits konfiguriert haben. Der Adapter liest lediglich die Streamliste und leitet die WebSocket-Verbindung weiter – er konfiguriert go2rtc nicht.

Registerkarte: Widget (Galerie-Widget pro Kamera)

Allgemein

Layout

Tags

Filter

Spieler

Farbthema – 5 Farbauswahlfelder + abgerundete Ecken:

Registerkarte: Erweitert

Live-Dashboard

Der Adapter verfügt über ein integriertes Live-Dashboard beihttp://<iobroker>:<webport>/agent-dvr.0/ Eine zweite Instanz ist erreichbar unter/agent-dvr.1/ , ein Drittel bei/agent-dvr.2/ , und so weiter.

Merkmale:

• Stream-Auswahl pro Kamera: MJPEG, MP4/FLV mit Audio (über flv.js) oder go2rtc WebRTC/MSE
• Kamerafilter-Schaltfläche (Trichtersymbol, Kopfzeile oben rechts) – öffnet ein Popup-Fenster mit Kontrollkästchen für jede Kamera und der Option „Alle“; die Anzeige zeigt die Anzahl der ausgeblendeten Kameras an; der Status wird im lokalen Speicher gespeichert.
• Vollbildansicht mit PTZ-Overlay, Aufnahmetaste, Stummschalttaste und nativem Browser-Vollbildmodus (Kopfzeile wird nach 3 Sekunden Inaktivität automatisch ausgeblendet; erscheint wieder bei Maus- oder Touch-Eingabe)
• Echtzeit-Bewegungs- (gelber Rahmen) und Alarmindikatoren (oranger Rahmen) über Socket.io
• Automatische Wiederverbindung: MJPEG und FLV stellen die Verbindung nach einem Fehler wieder her; go2rtc stellt die Verbindung nach einem unerwarteten WebSocket-Abbruch oder einer 10-sekündigen Pause wieder her.
• Registerkarte „Aufnahmen“ mit Raster-, Zeitleisten- und Ereignisprotokollansicht, Suche, ausklappbarem Tag-Filter und Videoplayer mit Zurück-/Weiter-Navigation
• Der Tag-Filter teilt die durch Kommas getrennten Tags von AgentDVR in einzelne Chips zur Filterung pro Tag auf.
• Aufnahmen im Videoplayer-Fenster löschen oder mehrere Aufnahmen durch langes Drücken auswählen und massenhaft löschen (erfordert AgentDVR v7.7.8.0+).
• Anzeigeeinstellungen für Aufnahmen – ⚙ Zahnradsymbol in der Auswahl-/Löschleiste; Schieberegler für die Spaltenbreite des Rasters, Überschreibung der maximalen Anzahl an Aufnahmen und Badge-Umschaltung – alles im lokalen Speicher gespeichert
• Das Symbol für neue Aufnahmen auf der Registerkarte „Aufnahmen“ zeigt an, wie viele Aufnahmen seit Ihrem letzten Besuch auf dieser Registerkarte eingegangen sind; der Basiswert wird im localStorage des Browsers gespeichert und ist browser- bzw. gerätespezifisch (wird nicht zwischen verschiedenen Browsern oder Geräten geteilt).
• Die Kamerafarben werden von AgentDVR ausgelesen und auf die Zeitleistenbalken und Aufzeichnungspunkte angewendet.
• PTZ-Voreinstellungen – Navigation zu gespeicherten Voreinstellungen über das PTZ-Overlay; ein einzelner Auswahldatenpunkt pro Kamera (erfordert AgentDVR v7.7.8.0+)
• Die Statusleiste zeigt die Anzahl der Kameras, die CPU-/RAM-Auslastung und den freien Speicherplatz an.
• Farbgestaltung über Adapterkonfiguration

go2rtc WebRTC-Streams

go2rtc bietet flüssige WebRTC/MSE-Streams mit niedriger Latenz und Audio.

Aufstellen:

1. Installieren und starten Sie go2rtc und konfigurieren Sie Ihre Kamerastreams in der go2rtc-Konfiguration.
2. Im Menüpunkt „Adapterkonfiguration → Dashboard“ weisen Sie jeder Kamera aus der Dropdown-Liste den gewünschten go2rtc-Streamnamen zu.
3. Geben Sie die go2rtc-URL ein, die unterhalb der Tabelle angezeigt wird (z. B.http://192.168.1.10:1984 ).
4. Speichern und neu starten. Der Adapter leitet WebSocket-Datenverkehr über ioBroker weiter, um browserübergreifende Beschränkungen zu umgehen.

Medienproxy

Der Adapter leitet alle Medien über ioBroker, sodass der Browser keine direkte Verbindung zu AgentDVR benötigt. Aktivieren Sie den Medienproxy auf der Registerkarte „Funktionen“.

FLV und go2rtc laufen unabhängig von den Einstellungen immer über ioBroker – der Browser kann keine ursprungsübergreifenden Anfragen direkt an diese Endpunkte senden.

Wann aktivieren?

• Sie greifen von außerhalb Ihres Heimnetzwerks auf das Dashboard zu, wenn AgentDVR nicht direkt über den Browser erreichbar ist.
• Lediglich ioBroker ist extern zugänglich (z. B. über einen Reverse-Proxy oder ein VPN, das ausschließlich auf ioBroker zugreift).

Wann sollte man es abstellen?

• Browser und AgentDVR befinden sich im selben Netzwerk (lokaler Zugriff).
• Direkte Verbindung ist schneller – kein zusätzlicher Zwischenknoten, geringere Latenz.
• Geringere Belastung des ioBroker-Servers – Streams werden nicht über Node.js geleitet.

Die Einstellung wird sofort nach dem Speichern wirksam – ein Neustart ist nicht erforderlich.

Datenpunkte

<cam> steht fürcam_<oid>_<name> z.B.cam_8_Reolink Die

System

Systemsteuerung (erfordert "Systemsteuerungsknöpfe")

Pro Kamera

PTZ (erfordert "PTZ-Steuertasten")

Stream-URLs (erfordert „Stream-URLs generieren“)

Veranstaltungen / Galerie (nur Kameras)

Webhook

Der Adapter stellt einen Webhook-Endpunkt bereit, der eine sofortige vollständige Abfrage von AgentDVR auslöst:

GET http://<iobroker>:<webport>/agent-dvr.0/webhook

Ersetzenagent-dvr.0 mit der tatsächlichen Instanznummer (agent-dvr.1 usw.), wenn Sie mehrere Instanzen ausführen.

Konfigurieren Sie diese URL als Aktion in AgentDVR (Kamera → Bearbeiten → Benachrichtigungen → Aktionen → URL), um Echtzeit-Updates zu erhalten, sobald eine Aufnahme beendet oder eine Benachrichtigung ausgelöst wird. Der Adapter ruft dann umgehend alle Kameradaten, Aufnahmen und Systemstatistiken neu ab – ein Warten auf den nächsten Abfragezyklus ist nicht erforderlich.

Rücksendungen{"ok":true} auf Erfolg.

Übersicht (erfordert das "Übersichts-Widget")

Changelog

0.5.2 (2026-08-05)

• (ipod86) feat: rename overview DP to widget_live_overview for consistent naming

0.5.1 (2026-08-05)

• (ipod86) feat: per-instance URL routing — each adapter instance uses its own URL namespace (agent-dvr.0/, agent-dvr.1/, …)
• (ipod86) feat: rename per-camera recording widget DP from widget to widget_recordings; add new widget_live DP with a single-camera live tile

0.5.0 (2026-08-03)

• (ipod86) feat: replace live-view camera chip-bar with compact header filter button — funnel icon opens a popover with per-camera checkboxes and drag-to-reorder; order persisted in localStorage
• (ipod86) feat: new-recordings badge on the Recordings tab — shows count of recordings since last visit; persisted per browser/device in localStorage
• (ipod86) feat: recording display settings panel — ⚙ gear button in the select/delete bar; grid column width slider, max-recordings override, badge toggle (all persisted in localStorage)
• (ipod86) feat: first-visit onboarding modals for live view (camera filter & sort) and recordings tab (gestures, gear panel, badge)
• (ipod86) feat: webhook endpoint /agent-dvr.0/webhook triggers immediate full poll — configure as AgentDVR action for real-time updates
• (ipod86) feat: PTZ presets — navigate to saved presets from PTZ overlay; single selector DP <cam>.control.ptz.preset per camera (requires AgentDVR v7.7.8.0+)
• (ipod86) feat: add event log view to recordings panel (clock icon toggle) alongside grid and timeline
• (ipod86) feat: delete recording from video modal (trash icon, two-click confirm, requires AgentDVR v7.7.8.0+)
• (ipod86) feat: bulk-delete recordings — long-press a tile to enter select mode, checkbox each recording, delete all at once
• (ipod86) feat: new dashMaxRec config setting — limits total recordings shown across all cameras in the dashboard (independent of widget limit, default 200)
• (ipod86) feat: tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
• (ipod86) feat: read camera color from AgentDVR and use it for timeline bars and recording dots
• (ipod86) feat: status bar shows CPU usage, RAM % and free, disk usage % and free alongside camera/recording counts
• (ipod86) feat: reset colors to defaults button in Live Dashboard settings tab
• (ipod86) refactor: remove per-camera pushTrigger data points in favour of the global webhook
• (ipod86) fix: new-recordings badge now correctly visible (display:none CSS fallback fixed)
• (ipod86) fix: record button moved to rightmost position in grid tiles and fullscreen panel
• (ipod86) fix: camera filter button no longer changes appearance when cameras are hidden
• (ipod86) fix: header z-index lifted so the camera filter popover renders above the main content area
• (ipod86) fix: drive object pruning regex corrected; stale drive entries are now properly removed
• (ipod86) fix: deleted recordings no longer reappear after the next adapter poll
• (ipod86) fix: extend video format error message with AgentDVR auto-convert hint in all 11 languages
• (ipod86) fix: FLV stream and grid tile layout scaling corrections
• (ipod86) fix: Italian i18n string with apostrophe broke page JS (changed to escaped variant)
• (ipod86) fix: detect AgentDVR "Command not found" response on delete and show proper error message

0.4.3 (2026-07-19)

• (ipod86) fix: switch polling loop from setInterval to setTimeout to prevent concurrent poll runs
• (ipod86) fix: httpTimeoutMs=0 now correctly clamps to 1000ms instead of falling back to default
• (ipod86) fix: go2rtcEnabled config flag is now honored in fetchGo2rtcStreams
• (ipod86) fix: remove unused isSupportedLang export from widget-i18n

0.4.2 (2026-07-12)

• (ipod86) fix: FLV stream proxy now sends Authorization header (HTTP 401 with AgentDVR auth)
• (ipod86) fix: dashboard camera online status was read from wrong state path (data.online → status.online)
• (ipod86) fix: MP4/FLV stream label was hardcoded German — now translated in all 11 languages
• (ipod86) fix: admin UI default values now match io-package.json (dashTagPosition, widgetAnzahl, widgetBorderRadius)
• (ipod86) fix: go2rtcEnabled flag now respected when loading streams in admin UI
• (ipod86) fix: enableStreamProxy missing from native defaults in io-package.json

0.4.1 (2026-07-12)

• (ipod86) fix: overview tile links to ioBroker host; go2rtc URL shown only when enabled

0.4.0 (2026-07-12)

• (ipod86) feat: optional MJPEG and snapshot stream proxy through ioBroker (browser needs only one connection to ioBroker, not directly to AgentDVR)

0.3.0 (2026-07-06)

• (ipod86) feat: add scheduleOn/Off and detectorOn/Off control buttons for cameras and microphones
• (ipod86) feat: add sensitivityMin, sensitivityMax, sensitivityGain level states for cameras (0–100)
• (ipod86) feat: add audio_mp3 and audio_ogg URL states for microphones
• (ipod86) fix: restrict objectDetectOn/Off and snapshot buttons to cameras (ot=2) only
• (ipod86) feat: inline flv.js into dashboard HTML — no external file required
• (ipod86) fix: preserve FLV stream aspect ratio after tab visibility change (all three player call sites)
• (ipod86) feat: collapsible tag filter row on recordings and timeline pages
• (ipod86) feat: native browser fullscreen button in live view modal with correct aspect ratio
• (ipod86) feat: live view modal header auto-hides after 3 s of inactivity; reappears on mouse/touch
• (ipod86) fix: add fsEnter, fsExit, filterByLabel, timelineView, closePanel i18n keys in all 10 languages

License

MIT License

Copyright (c) 2026 ipod86 david@graef.email

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.