iobroker.agent-dvr 0.4.3 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md CHANGED
@@ -9,6 +9,11 @@
9
9
 
10
10
  Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automatisch alle Kameras, spiegelt jede Geräteeigenschaft als Datenpunkt, stellt Schaltflächen für alle gängigen Befehle bereit (Aufnahme, Scharf, PTZ, …), liefert Push-getriggerte Galerie-Updates bei neuen Aufnahmen, erzeugt ein responsives HTML-Galerie-Widget pro Kamera und enthält ein eingebautes Live-Dashboard mit kameraindividueller Stream-Auswahl (MJPEG, MP4/FLV mit Ton oder go2rtc WebRTC).
11
11
 
12
+ ## Voraussetzungen
13
+
14
+ - ioBroker mit `iobroker.web` Adapter
15
+ - **AgentDVR ≥ 7.8.0.0** — ältere Versionen haben eine Regression im `streamFile.cgi`-Endpunkt (fehlerhafte Chunked-Kodierung, falscher MIME-Typ), die die Wiedergabe von Aufzeichnungen im integrierten Dashboard verhindert. Der Entwickler hat bestätigt, dass der Fix in Version 7.8.0.0 enthalten ist.
16
+
12
17
  ## Funktionen
13
18
 
14
19
  - Automatische Erkennung aller AgentDVR-Kameras beim Start (Mikrofone ausgenommen)
@@ -19,15 +24,20 @@ Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automati
19
24
  - **Snapshot als Base64** — `snapshot_b64`-Zustand pro Kamera, per Schaltfläche oder automatisch bei jedem Poll aktualisierbar
20
25
  - PTZ-Steuerung mit Halte-Schaltern (links, rechts, oben, unten, diagonal, Zoom, Stopp, Mitte)
21
26
  - Stream-URLs pro Kamera (Snapshot, Foto, MJPEG, MP4)
22
- - Push-Trigger-Zustand für sofortige Skript-Reaktionen auf neue Aufnahmen
23
- - HTML-Galerie-Widget pro Kamera (reines HTML/CSS oder JS-Modus mit Suche und Tag-Filter)
27
+ - Webhook-Endpunkt für Echtzeit-Updates — per AgentDVR-Action aufrufbar, löst sofortigen vollständigen Poll aus
28
+ - HTML-Aufnahme-Widget pro Kamera (`widget_recordings`) und Live-Einzelkachelansicht (`widget_live`) — reines HTML/CSS oder JS-Modus mit Suche und Tag-Filter
24
29
  - Übersichts-Widget, das alle Kameras in einem HTML-Zustand kombiniert
25
- - **Eingebautes Live-Dashboard** unter `http://<iobroker>:<webport>/agent-dvr/` — keine zusätzliche App nötig:
30
+ - **Eingebautes Live-Dashboard** unter `http://<iobroker>:<webport>/agent-dvr.0/` — keine zusätzliche App nötig:
26
31
  - Kameraindividuelle Stream-Auswahl: MJPEG, MP4/FLV mit Ton oder go2rtc WebRTC/MSE
27
- - Kamera-Filter-Badges zum Ein-/Ausblenden einzelner Kameras (Zustand im localStorage gespeichert)
32
+ - Kamera-Filter-Schaltfläche im Header (Trichter-Symbol) — öffnet ein Popover mit Checkboxen pro Kamera und einem „Alle"-Toggle; Badge zeigt Anzahl verborgen Kameras; Zustand im localStorage gespeichert
28
33
  - Echtzeit-Bewegungs- und Alarm-Indikatoren (gelber / oranger Kachelrahmen) via Socket.io
29
- - Vollbildansicht mit PTZ-Overlay, Aufnahme-, Ton- und **nativer Browser-Vollbild-Schaltfläche**; Header blendet sich nach 3 s Inaktivität aus
30
- - Aufnahmen-Tab mit Raster- und Timeline-Ansicht, Suche, **ausklappbarem Tag-Filter** und Video-Player
34
+ - Vollbildansicht mit PTZ-Overlay, Aufnahme-, Ton- und nativer Browser-Vollbild-Schaltfläche; Header blendet sich nach 3 s Inaktivität aus
35
+ - Aufnahmen-Tab mit Raster-, Timeline- und Ereignisprotokoll-Ansicht, Suche, ausklappbarem Tag-Filter und Video-Player mit Vor-/Zurück-Navigation
36
+ - Aufnahme löschen direkt aus dem Video-Player-Modal (ab AgentDVR v7.7.8.0+)
37
+ - Aufnahmen-Anzeigeeinstellungen — ⚙ Zahnrad im Auswahl-/Löschen-Balken; Schieberegler für Rasterspaltengröße, maximale Aufnahmen-Anzahl und Badge-Toggle — alles im localStorage gespeichert
38
+ - Kamerafarben werden aus AgentDVR gelesen und für Timeline-Balken und Aufnahme-Punkte verwendet
39
+ - PTZ-Presets — gespeicherte Positionen im PTZ-Overlay anzeigen und anfahren (ab AgentDVR v7.7.8.0+)
40
+ - Statuszeile zeigt Kameraanzahl im Live-Bereich und Aufnahmen-/Ereignisanzahl im Aufnahmen-Bereich
31
41
  - Automatischer Reconnect für alle Stream-Typen nach Netzwerkunterbrechung oder Tab-Wechsel
32
42
  - Farbdesign vollständig über die Adapter-Konfiguration anpassbar
33
43
 
@@ -60,7 +70,6 @@ Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automati
60
70
  | Einstellung | Beschreibung | Standard |
61
71
  |-------------|-------------|---------|
62
72
  | Ereignis-Datenpunkte | Aufnahme-Metadaten (neuestes Ereignis, Anzahl, Tags, …) pro Kamera spiegeln | `ja` |
63
- | Echtzeit-Push-Trigger | Push-Trigger-Zustand anlegen, auf den Skripte bei neuen Aufnahmen reagieren können | `ja` |
64
73
 
65
74
  **Anzeige**
66
75
 
@@ -68,6 +77,12 @@ Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automati
68
77
  |-------------|-------------|---------|
69
78
  | Übersichts-Widget | Einen HTML-Zustand mit allen Kamerakacheln zusammengefasst anlegen | `ja` |
70
79
 
80
+ **Proxy**
81
+
82
+ | Einstellung | Beschreibung | Standard |
83
+ |-------------|-------------|---------|
84
+ | Medien-Proxy | MJPEG-Streams, Snapshots, Aufnahmen-Vorschaubilder und Videos über ioBroker leiten | `nein` |
85
+
71
86
  **Debug**
72
87
 
73
88
  | Einstellung | Beschreibung | Standard |
@@ -82,6 +97,7 @@ Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automati
82
97
  |-------------|-------------|---------|
83
98
  | Standardansicht | Welcher Tab beim Öffnen des Dashboards aktiv ist: Live oder Aufnahmen | `Live` |
84
99
  | Offline-Kameras anzeigen | Kamerakacheln auch dann anzeigen, wenn die Kamera offline ist | `ja` |
100
+ | Max. Aufnahmen gesamt | Maximale Gesamtanzahl Aufnahmen, die das Dashboard über alle Kameras hinweg anzeigt (neueste zuerst). Unabhängig vom Widget-Limit. | `200` |
85
101
 
86
102
  **Kameraraster**
87
103
 
@@ -194,15 +210,23 @@ Die go2rtc-Streamnamen werden automatisch vom go2rtc-Server abgerufen, wenn das
194
210
 
195
211
  ## Live-Dashboard
196
212
 
197
- Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/agent-dvr/`.
213
+ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/agent-dvr.0/`.
214
+ Eine zweite Instanz ist unter `/agent-dvr.1/` erreichbar, eine dritte unter `/agent-dvr.2/` usw.
198
215
 
199
216
  **Funktionen:**
200
217
  - Kameraindividuelle Stream-Auswahl: MJPEG, MP4/FLV mit Ton (via flv.js) oder go2rtc WebRTC/MSE
201
- - Kamera-Filter-Badges — per Klick einzelne Kameras ein-/ausblenden; Zustand wird im localStorage gespeichert
218
+ - Kamera-Filter-Schaltfläche (Trichter-Symbol, oben rechts im Header) — öffnet ein Popover mit Checkboxen pro Kamera und „Alle"-Toggle; Badge zeigt Anzahl verborgener Kameras; Zustand im localStorage gespeichert
202
219
  - Vollbildansicht mit PTZ-Overlay, Aufnahme-, Ton- und nativer Browser-Vollbild-Schaltfläche; Header blendet sich nach 3 s Inaktivität aus
203
220
  - Echtzeit-Bewegungs- (gelber Rahmen) und Alarm-Indikatoren (oranger Rahmen) via Socket.io
204
221
  - Automatischer Reconnect: MJPEG und FLV bei Fehler; go2rtc bei unerwartetem WebSocket-Close oder 10 s ohne Bild
205
- - Aufnahmen-Tab mit Raster- und Timeline-Ansicht, Suche und ausklappbarem Tag-Filter, Video-Player mit Vor-/Zurück-Navigation
222
+ - Aufnahmen-Tab mit Raster-, Timeline- und Ereignisprotokoll-Ansicht, Suche, ausklappbarem Tag-Filter und Video-Player mit Vor-/Zurück-Navigation
223
+ - Tag-Filter splittet AgentDVRs kommagetrennte Tags in einzelne Chips — jeder Tag einzeln filterbar
224
+ - Aufnahme löschen aus dem Video-Player-Modal oder per Mehrfachauswahl (Langer Druck → Checkbox-Modus, Sammel-Löschen, ab AgentDVR v7.7.8.0+)
225
+ - Aufnahmen-Anzeigeeinstellungen — ⚙ Zahnrad im Auswahl-/Löschen-Balken; Schieberegler für Rasterspaltengröße, Override für maximale Aufnahmen und Badge-Toggle — alles im localStorage gespeichert
226
+ - „Neue Aufnahmen"-Badge am Aufnahmen-Tab — zeigt an, wie viele Aufnahmen seit dem letzten Tab-Besuch hinzugekommen sind; der Ausgangswert wird im localStorage des Browsers gespeichert und ist gerätebezogen (nicht geräte- oder browserübergreifend synchronisiert)
227
+ - Kamerafarben werden aus AgentDVR gelesen und für Timeline-Balken und Aufnahme-Punkte verwendet
228
+ - PTZ-Presets — gespeicherte Positionen im PTZ-Overlay anzeigen und anfahren; ein Selektor-Datenpunkt pro Kamera (ab AgentDVR v7.7.8.0+)
229
+ - Statuszeile zeigt Kameraanzahl, CPU-/RAM-Auslastung und freien Festplattenspeicher
206
230
  - Farbdesign über die Adapter-Konfiguration einstellbar
207
231
 
208
232
  ### go2rtc WebRTC-Streams
@@ -215,6 +239,34 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
215
239
  3. Die **go2rtc-URL** eintragen, die unterhalb der Tabelle erscheint (z. B. `http://192.168.1.10:1984`).
216
240
  4. Speichern und Adapter neu starten. Der Adapter proxied den WebSocket-Traffic über ioBroker, um Browser-CORS-Probleme zu umgehen.
217
241
 
242
+ ## Medien-Proxy
243
+
244
+ Der Adapter kann alle Medien über ioBroker leiten, sodass der Browser keine direkte Verbindung zu AgentDVR benötigt. Den **Medien-Proxy** aktivierst du im Tab „Funktionen".
245
+
246
+ | Was wird geleitet | Proxy aus | Proxy an |
247
+ |-------------------|-----------|----------|
248
+ | MJPEG-Livestream | direkte AgentDVR-URL | `/agent-dvr.0/api/mjpeg?oid=…` |
249
+ | Snapshot | direkte AgentDVR-URL | `/agent-dvr.0/api/snap?oid=…` |
250
+ | Aufnahmen-Vorschaubilder | direkte AgentDVR-URL | `/agent-dvr.0/api/thumb?oid=…` |
251
+ | Aufnahmen-Videos | direkte AgentDVR-URL | `/agent-dvr.0/api/media?oid=…` |
252
+ | FLV-Livestream | **immer über ioBroker** | **immer über ioBroker** |
253
+ | go2rtc-WebSocket | **immer über ioBroker** | **immer über ioBroker** |
254
+
255
+ FLV und go2rtc laufen unabhängig von der Einstellung immer über ioBroker — der Browser kann diese Endpunkte aus technischen Gründen nicht direkt ansprechen (Browser-Cross-Origin-Beschränkung).
256
+
257
+ ### Wann einschalten
258
+
259
+ - Du rufst das Dashboard von außerhalb deines Heimnetzes auf, wo AgentDVR vom Browser aus nicht direkt erreichbar ist
260
+ - Nur ioBroker ist nach außen erreichbar (z. B. über einen Reverse-Proxy oder VPN nur zu ioBroker)
261
+
262
+ ### Wann ausgelassen lassen
263
+
264
+ - Browser und AgentDVR sind im gleichen Netzwerk (lokaler Zugriff)
265
+ - Direktverbindung ist schneller — kein Umweg, geringere Latenz
266
+ - Weniger Last auf dem ioBroker-Server — Streams müssen nicht durch Node.js laufen
267
+
268
+ > Die Einstellung wird sofort nach dem Speichern wirksam — kein Neustart erforderlich.
269
+
218
270
  ## Datenpunkte
219
271
 
220
272
  `<cam>` steht für `cam_<oid>_<name>`, z. B. `cam_8_Reolink`.
@@ -307,6 +359,7 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
307
359
  | `<cam>.control.ptz.zoomOut` | Schalter | R/W | Herauszoomen |
308
360
  | `<cam>.control.ptz.stop` | Taste | W | PTZ-Bewegung stoppen |
309
361
  | `<cam>.control.ptz.center` | Taste | W | Mitte-/Ausgangsposition anfahren |
362
+ | `<cam>.control.ptz.preset` | Zahl | R/W | Preset-Selektor — Index schreiben um die Position anzufahren; States-Enum enthält die Preset-Namen (ab AgentDVR v7.7.8.0+) |
310
363
 
311
364
  ### Stream-URLs *(erfordert „Stream-URLs generieren")*
312
365
 
@@ -324,8 +377,22 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
324
377
  | Datenpunkt | Typ | R/W | Beschreibung |
325
378
  |-----------|-----|-----|-------------|
326
379
  | `<cam>.events.*` | verschieden | R | Metadaten der letzten Aufnahme — erfordert „Ereignis-Datenpunkte" |
327
- | `<cam>.push` | string | R | Push-Trigger — wird bei neuer Aufnahme sofort aktualisiert — erfordert „Echtzeit-Push-Trigger" |
328
- | `<cam>.gallery` | string | R | HTML-Aufnahmegalerie — erfordert „Galerie-Widget" |
380
+ | `<cam>.widget_recordings` | string | R | HTML-Aufnahmegalerie — erfordert „Galerie-Widget" |
381
+ | `<cam>.widget_live` | string | R | HTML-Live-Einzelkachel der Kamera — erfordert „Galerie-Widget" |
382
+
383
+ ## Webhook
384
+
385
+ Der Adapter stellt einen Webhook-Endpunkt bereit, der einen sofortigen vollständigen Poll auslöst:
386
+
387
+ ```
388
+ GET http://<iobroker>:<webport>/agent-dvr.0/webhook
389
+ ```
390
+
391
+ `agent-dvr.0` durch die tatsächliche Instanznummer ersetzen (`agent-dvr.1` usw.) wenn mehrere Instanzen laufen.
392
+
393
+ Diese URL als **Action** in AgentDVR eintragen (Kamera → Bearbeiten → Alarme → Actions → URL), um bei abgeschlossenen Aufnahmen oder Alarmen sofortige Aktualisierungen zu erhalten. Der Adapter holt dann sofort alle Kameradaten, Aufnahmen und Systemstats neu — ohne auf den nächsten Poll-Zyklus warten zu müssen.
394
+
395
+ Gibt `{"ok":true}` bei Erfolg zurück.
329
396
 
330
397
  ### Übersicht *(erfordert „Übersichts-Widget")*
331
398
 
@@ -339,6 +406,43 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
339
406
  Placeholder for the next version (at the beginning of the line):
340
407
  ### **WORK IN PROGRESS**
341
408
  -->
409
+ ### 0.5.1 (2026-08-05)
410
+ * (ipod86) feat: Instanz-eigenes URL-Routing — jede Adapter-Instanz erhält einen eigenen URL-Namespace (`agent-dvr.0/`, `agent-dvr.1/`, …)
411
+ * (ipod86) feat: Aufnahme-Widget-Datenpunkt pro Kamera von `widget` zu `widget_recordings` umbenannt; neuer Datenpunkt `widget_live` mit Live-Einzelkachel der Kamera
412
+
413
+ ### 0.5.0 (2026-08-03)
414
+ * (ipod86) feat: Kamera-Chip-Leiste durch kompakten Header-Filter-Button ersetzt — Trichter-Icon öffnet Popover mit Checkboxen und Drag-to-Reorder; Reihenfolge im localStorage gespeichert
415
+ * (ipod86) feat: Neue-Aufnahmen-Badge am Aufnahmen-Tab — zeigt Anzahl neuer Aufnahmen seit letztem Besuch; browser- und gerätebezogen im localStorage gespeichert
416
+ * (ipod86) feat: Aufnahmen-Anzeigeeinstellungen — ⚙ Zahnrad im Auswahl-/Löschen-Balken; Schieberegler für Rasterspaltengröße, maximale Aufnahmen und Badge-Toggle (alles im localStorage)
417
+ * (ipod86) feat: Erstbesuchs-Hinweis-Modals für Live-Ansicht (Filter & Sortierung) und Aufnahmen-Tab (Gesten, Zahnrad, Badge)
418
+ * (ipod86) feat: Webhook-Endpunkt `/agent-dvr.0/webhook` löst sofortigen vollständigen Poll aus — als AgentDVR-Action konfigurierbar für Echtzeit-Updates
419
+ * (ipod86) feat: PTZ-Presets — gespeicherte Positionen im PTZ-Overlay anzeigen und anfahren; Selektor-Datenpunkt `<cam>.control.ptz.preset` pro Kamera (ab AgentDVR v7.7.8.0+)
420
+ * (ipod86) feat: Ereignisprotokoll-Ansicht im Aufnahmen-Bereich (Uhr-Icon neben Raster und Timeline)
421
+ * (ipod86) feat: Aufnahme löschen direkt aus dem Video-Player-Modal (Papierkorb, 2-Klick-Bestätigung, ab AgentDVR v7.7.8.0+)
422
+ * (ipod86) feat: Mehrfachauswahl im Aufnahmen-Bereich — langer Druck aktiviert Checkbox-Modus, Sammel-Löschen und „Alle auswählen"-Schaltfläche
423
+ * (ipod86) feat: neue Einstellung `dashMaxRec` — begrenzt die Gesamtanzahl Aufnahmen im Dashboard über alle Kameras (unabhängig vom Widget-Limit, Standard 200)
424
+ * (ipod86) feat: Tag-Filter splittet kommagetrennte Tags in einzelne Chips für kameraübergreifende Filterung pro Tag
425
+ * (ipod86) feat: Kamerafarbe aus AgentDVR lesen und für Timeline-Balken und Aufnahme-Punkte verwenden
426
+ * (ipod86) feat: Statuszeile zeigt CPU-Auslastung, RAM-% und freien Speicher sowie freien Festplattenspeicher
427
+ * (ipod86) feat: Farben-auf-Werkseinstellung-Schaltfläche im Tab „Live-Dashboard" der Adapter-Einstellungen
428
+ * (ipod86) refactor: pro-Kamera pushTrigger-Datenpunkte durch globalen Webhook ersetzt
429
+ * (ipod86) fix: Neue-Aufnahmen-Badge jetzt korrekt sichtbar (display:none CSS-Fallback behoben)
430
+ * (ipod86) fix: Aufnahme-Schaltfläche an die rechteste Position in Raster-Kacheln und Vollbild-Panel verschoben
431
+ * (ipod86) fix: Kamera-Filter-Button ändert sein Aussehen nicht mehr wenn Kameras ausgeblendet sind
432
+ * (ipod86) fix: Header-Z-Index angehoben, damit das Filter-Popover über dem Hauptinhalt gerendert wird
433
+ * (ipod86) fix: Pruning-Regex für Drive-Objekte korrigiert; veraltete Drive-Einträge werden jetzt korrekt entfernt
434
+ * (ipod86) fix: gelöschte Aufnahmen erscheinen nach dem nächsten Adapter-Poll nicht mehr erneut
435
+ * (ipod86) fix: Videofehler-Hinweis um AgentDVR-Auto-Konvertierungs-Hinweis in allen 11 Sprachen erweitert
436
+ * (ipod86) fix: FLV-Stream- und Raster-Kachel-Skalierung korrigiert
437
+ * (ipod86) fix: Apostroph im italienischen i18n-String hat die gesamte Seiten-JS gebrochen
438
+ * (ipod86) fix: AgentDVR-Antwort „Command not found" beim Löschen wird jetzt erkannt und als Fehler angezeigt
439
+
440
+ ### 0.4.3 (2026-07-19)
441
+ * (ipod86) fix: Poll-Schleife von setInterval auf setTimeout umgestellt (verhindert parallele Polls)
442
+ * (ipod86) fix: httpTimeoutMs=0 wird jetzt korrekt auf 1000 ms geclampt statt auf Standardwert zu fallen
443
+ * (ipod86) fix: go2rtcEnabled-Flag wird in fetchGo2rtcStreams jetzt berücksichtigt
444
+ * (ipod86) fix: nicht verwendeter isSupportedLang-Export aus widget-i18n entfernt
445
+
342
446
  ### 0.4.2 (2026-07-12)
343
447
  * (ipod86) fix: FLV-Stream-Proxy sendet jetzt Authorization-Header (HTTP 401 bei AgentDVR-Auth)
344
448
  * (ipod86) fix: Online-Status der Kameras wurde aus falschem State-Pfad gelesen (data.online → status.online)
package/README.md CHANGED
@@ -14,6 +14,11 @@
14
14
 
15
15
  Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all cameras, mirrors every device property as data points, provides buttons for all common commands (record, arm, PTZ, …), delivers push-triggered gallery updates on new recordings, generates a responsive HTML gallery widget per camera, and includes a built-in live dashboard with per-camera stream selection (MJPEG, MP4/FLV with audio, or go2rtc WebRTC).
16
16
 
17
+ ## Requirements
18
+
19
+ - ioBroker with `iobroker.web` adapter
20
+ - **AgentDVR ≥ 7.8.0.0** — earlier versions have a regression in the `streamFile.cgi` endpoint (malformed chunked encoding, wrong MIME type) that prevents recording playback in the built-in dashboard. The developer has confirmed the fix is included in 7.8.0.0.
21
+
17
22
  ## Features
18
23
 
19
24
  - Auto-discovery of all AgentDVR cameras on startup (microphones excluded)
@@ -24,15 +29,20 @@ Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all
24
29
  - **Snapshot as Base64** — `snapshot_b64` state per camera, writable via button or auto-updated every poll cycle
25
30
  - PTZ control with hold-to-move switches
26
31
  - Stream URLs per camera (snapshot, photo, MJPEG, MP4)
27
- - Push trigger state for real-time script reactions to new recordings
28
- - HTML gallery widget per camera (pure HTML/CSS or full JS mode with search and tag filter)
32
+ - Webhook endpoint for real-time updates — call it from an AgentDVR action to trigger an immediate full poll
33
+ - HTML recording gallery widget per camera (`widget_recordings`) and single-camera live tile (`widget_live`) — pure HTML/CSS or full JS mode with search and tag filter
29
34
  - Overview widget combining all cameras in one HTML state
30
- - **Built-in live dashboard** at `http://<iobroker>:<webport>/agent-dvr/` — no additional app needed:
35
+ - **Built-in live dashboard** at `http://<iobroker>:<webport>/agent-dvr.0/` — no additional app needed:
31
36
  - Per-camera stream selection: MJPEG, MP4/FLV with audio, or go2rtc WebRTC/MSE
32
- - Camera filter badges to show/hide individual cameras (state saved in localStorage)
37
+ - Camera filter button in the header (funnel icon) — opens a per-camera checkbox popover; badge shows how many cameras are hidden; state saved in localStorage
33
38
  - Real-time motion and alert indicators (yellow / orange tile border) via Socket.io
34
39
  - Fullscreen view with PTZ overlay, record, mute, and native browser fullscreen button; header auto-hides
35
- - Recordings tab with grid and timeline view, search, collapsible tag filter, and video player
40
+ - Recordings tab with grid, timeline, and event log view, search, collapsible tag filter, and video player with prev/next navigation
41
+ - Delete recording directly from the video player modal (requires AgentDVR v7.7.8.0+)
42
+ - Recording display settings — ⚙ gear in the select/delete bar adjusts grid column width, max recordings shown and badge visibility (persisted in localStorage)
43
+ - Camera colors are read from AgentDVR and applied to timeline bars and recording dots
44
+ - PTZ presets — navigate to saved presets from the PTZ overlay (requires AgentDVR v7.7.8.0+)
45
+ - Status bar shows camera count on the live view and recording/event count on the recordings view
36
46
  - Auto-reconnect for all stream types after network interruption or tab switch
37
47
  - Fully color-themeable via adapter config
38
48
 
@@ -65,7 +75,6 @@ Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all
65
75
  | Setting | Description | Default |
66
76
  |---------|-------------|---------|
67
77
  | Event data points | Mirror recording metadata (latest event, count, tags, …) per camera | `true` |
68
- | Real-time push trigger | Create a push-trigger state that scripts can subscribe to for new recordings | `true` |
69
78
 
70
79
  **Display**
71
80
 
@@ -73,6 +82,12 @@ Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all
73
82
  |---------|-------------|---------|
74
83
  | Overview widget | Single HTML state combining all camera live tiles | `true` |
75
84
 
85
+ **Proxy**
86
+
87
+ | Setting | Description | Default |
88
+ |---------|-------------|---------|
89
+ | Media proxy | Route MJPEG streams, snapshots, recording thumbnails and videos through ioBroker | `false` |
90
+
76
91
  **Debug**
77
92
 
78
93
  | Setting | Description | Default |
@@ -87,6 +102,7 @@ Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all
87
102
  |---------|-------------|---------|
88
103
  | Default view | Which tab opens when the dashboard loads: Live or Recordings | `Live` |
89
104
  | Show offline cameras | Display camera tiles even when the camera is offline | `true` |
105
+ | Max. recordings total | Maximum number of recordings shown across all cameras in the dashboard (newest first). Independent of the widget limit. | `200` |
90
106
 
91
107
  **Camera grid**
92
108
 
@@ -199,15 +215,23 @@ The go2rtc stream names are fetched automatically from the go2rtc server when th
199
215
 
200
216
  ## Live Dashboard
201
217
 
202
- The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agent-dvr/`.
218
+ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agent-dvr.0/`.
219
+ A second instance is reachable at `/agent-dvr.1/`, a third at `/agent-dvr.2/`, and so on.
203
220
 
204
221
  **Features:**
205
222
  - Per-camera stream selection: MJPEG, MP4/FLV with audio (via flv.js), or go2rtc WebRTC/MSE
206
- - Camera filter badges — click to show/hide individual cameras; state persisted in localStorage
207
- - Fullscreen view with PTZ overlay, record button, mute button, and **native browser fullscreen** (header auto-hides after 3 s of inactivity; reappears on mouse or touch)
223
+ - Camera filter button (funnel icon, header top-right) — opens a per-camera checkbox popover with an "All" toggle; badge shows the number of hidden cameras; state persisted in localStorage
224
+ - Fullscreen view with PTZ overlay, record button, mute button, and native browser fullscreen (header auto-hides after 3 s of inactivity; reappears on mouse or touch)
208
225
  - Real-time motion (yellow border) and alert (orange border) indicators via Socket.io
209
226
  - Auto-reconnect: MJPEG and FLV reconnect after error; go2rtc reconnects after unexpected WebSocket close or 10 s stall
210
- - Recordings tab with grid and timeline view, search, **collapsible tag filter**, and video player with prev/next navigation
227
+ - Recordings tab with grid, timeline, and event log view, search, collapsible tag filter, and video player with prev/next navigation
228
+ - Tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
229
+ - Delete recording from the video player modal or select multiple with a long-press and bulk-delete (requires AgentDVR v7.7.8.0+)
230
+ - Recording display settings — ⚙ gear button in the select/delete bar; slider for grid column width, max recordings override, and badge toggle — all saved in localStorage
231
+ - New-recordings badge on the Recordings tab — shows how many recordings arrived since you last visited that tab; the baseline is stored in the browser's localStorage and is per-browser/per-device (not shared across different browsers or devices)
232
+ - Camera colors are read from AgentDVR and applied to timeline bars and recording dots
233
+ - PTZ presets — navigate to saved presets from the PTZ overlay; single selector data point per camera (requires AgentDVR v7.7.8.0+)
234
+ - Status bar shows camera count, CPU/RAM usage and disk free space
211
235
  - Color theming via adapter config
212
236
 
213
237
  ### go2rtc WebRTC Streams
@@ -220,6 +244,34 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
220
244
  3. Enter the **go2rtc URL** that appears below the table (e.g. `http://192.168.1.10:1984`).
221
245
  4. Save and restart. The adapter proxies WebSocket traffic through ioBroker to avoid browser cross-origin restrictions.
222
246
 
247
+ ## Media Proxy
248
+
249
+ The adapter can route all media through ioBroker so the browser never needs a direct connection to AgentDVR. Enable **Media proxy** on the Features tab.
250
+
251
+ | What is proxied | Proxy off | Proxy on |
252
+ |-----------------|-----------|----------|
253
+ | MJPEG live stream | direct AgentDVR URL | `/agent-dvr.0/api/mjpeg?oid=…` |
254
+ | Snapshot | direct AgentDVR URL | `/agent-dvr.0/api/snap?oid=…` |
255
+ | Recording thumbnails | direct AgentDVR URL | `/agent-dvr.0/api/thumb?oid=…` |
256
+ | Recording videos | direct AgentDVR URL | `/agent-dvr.0/api/media?oid=…` |
257
+ | FLV live stream | **always via ioBroker** | **always via ioBroker** |
258
+ | go2rtc WebSocket | **always via ioBroker** | **always via ioBroker** |
259
+
260
+ FLV and go2rtc always run through ioBroker regardless of the setting — the browser cannot make cross-origin requests to these endpoints directly.
261
+
262
+ ### When to enable
263
+
264
+ - You access the dashboard from outside your home network where AgentDVR is not directly reachable from the browser
265
+ - Only ioBroker is exposed externally (e.g. via reverse proxy or VPN to ioBroker only)
266
+
267
+ ### When to leave it off
268
+
269
+ - Browser and AgentDVR are on the same network (local access)
270
+ - Direct connection is faster — no extra hop, lower latency
271
+ - Less load on the ioBroker server — streams do not pass through Node.js
272
+
273
+ > The setting takes effect immediately after saving — no restart required.
274
+
223
275
  ## Data points
224
276
 
225
277
  `<cam>` stands for `cam_<oid>_<name>`, e.g. `cam_8_Reolink`.
@@ -312,6 +364,7 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
312
364
  | `<cam>.control.ptz.zoomOut` | switch | R/W | Zoom out |
313
365
  | `<cam>.control.ptz.stop` | button | W | Stop PTZ movement |
314
366
  | `<cam>.control.ptz.center` | button | W | Move to center/home position |
367
+ | `<cam>.control.ptz.preset` | number | R/W | Preset selector — write index to move to that preset; states enum lists preset names (requires AgentDVR v7.7.8.0+) |
315
368
 
316
369
  ### Stream URLs *(requires "Generate stream URLs")*
317
370
 
@@ -329,8 +382,22 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
329
382
  | Data point | Type | R/W | Description |
330
383
  |-----------|------|-----|-------------|
331
384
  | `<cam>.events.*` | various | R | Latest recording metadata — requires "Event data points" |
332
- | `<cam>.push` | string | R | Push trigger — updated when AgentDVR reports a new recording — requires "Real-time push trigger" |
333
- | `<cam>.gallery` | string | R | HTML recording gallery — requires "Gallery widget" |
385
+ | `<cam>.widget_recordings` | string | R | HTML recording gallery — requires "Gallery widget" |
386
+ | `<cam>.widget_live` | string | R | HTML single-camera live tile — requires "Gallery widget" |
387
+
388
+ ## Webhook
389
+
390
+ The adapter exposes a webhook endpoint that triggers an immediate full poll of AgentDVR:
391
+
392
+ ```
393
+ GET http://<iobroker>:<webport>/agent-dvr.0/webhook
394
+ ```
395
+
396
+ Replace `agent-dvr.0` with the actual instance number (`agent-dvr.1`, etc.) if you run multiple instances.
397
+
398
+ Configure this URL as an **Action** in AgentDVR (Camera → Edit → Alerts → Actions → URL) to get real-time updates whenever a recording finishes or an alert fires. The adapter will immediately re-fetch all camera data, recordings, and system stats — no need to wait for the next poll cycle.
399
+
400
+ Returns `{"ok":true}` on success.
334
401
 
335
402
  ### Overview *(requires "Overview widget")*
336
403
 
@@ -339,6 +406,37 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
339
406
  | `overview` | string | R | HTML tile grid of all cameras |
340
407
 
341
408
  ## Changelog
409
+ ### 0.5.1 (2026-08-05)
410
+ * (ipod86) feat: per-instance URL routing — each adapter instance uses its own URL namespace (`agent-dvr.0/`, `agent-dvr.1/`, …)
411
+ * (ipod86) feat: rename per-camera recording widget DP from `widget` to `widget_recordings`; add new `widget_live` DP with a single-camera live tile
412
+
413
+ ### 0.5.0 (2026-08-03)
414
+ * (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
415
+ * (ipod86) feat: new-recordings badge on the Recordings tab — shows count of recordings since last visit; persisted per browser/device in localStorage
416
+ * (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)
417
+ * (ipod86) feat: first-visit onboarding modals for live view (camera filter & sort) and recordings tab (gestures, gear panel, badge)
418
+ * (ipod86) feat: webhook endpoint `/agent-dvr.0/webhook` triggers immediate full poll — configure as AgentDVR action for real-time updates
419
+ * (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+)
420
+ * (ipod86) feat: add event log view to recordings panel (clock icon toggle) alongside grid and timeline
421
+ * (ipod86) feat: delete recording from video modal (trash icon, two-click confirm, requires AgentDVR v7.7.8.0+)
422
+ * (ipod86) feat: bulk-delete recordings — long-press a tile to enter select mode, checkbox each recording, delete all at once
423
+ * (ipod86) feat: new `dashMaxRec` config setting — limits total recordings shown across all cameras in the dashboard (independent of widget limit, default 200)
424
+ * (ipod86) feat: tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
425
+ * (ipod86) feat: read camera color from AgentDVR and use it for timeline bars and recording dots
426
+ * (ipod86) feat: status bar shows CPU usage, RAM % and free, disk usage % and free alongside camera/recording counts
427
+ * (ipod86) feat: reset colors to defaults button in Live Dashboard settings tab
428
+ * (ipod86) refactor: remove per-camera pushTrigger data points in favour of the global webhook
429
+ * (ipod86) fix: new-recordings badge now correctly visible (display:none CSS fallback fixed)
430
+ * (ipod86) fix: record button moved to rightmost position in grid tiles and fullscreen panel
431
+ * (ipod86) fix: camera filter button no longer changes appearance when cameras are hidden
432
+ * (ipod86) fix: header z-index lifted so the camera filter popover renders above the main content area
433
+ * (ipod86) fix: drive object pruning regex corrected; stale drive entries are now properly removed
434
+ * (ipod86) fix: deleted recordings no longer reappear after the next adapter poll
435
+ * (ipod86) fix: extend video format error message with AgentDVR auto-convert hint in all 11 languages
436
+ * (ipod86) fix: FLV stream and grid tile layout scaling corrections
437
+ * (ipod86) fix: Italian i18n string with apostrophe broke page JS (changed to escaped variant)
438
+ * (ipod86) fix: detect AgentDVR "Command not found" response on delete and show proper error message
439
+
342
440
  ### 0.4.3 (2026-07-19)
343
441
  * (ipod86) fix: switch polling loop from setInterval to setTimeout to prevent concurrent poll runs
344
442
  * (ipod86) fix: httpTimeoutMs=0 now correctly clamps to 1000ms instead of falling back to default