iobroker.agent-dvr 0.4.2 → 0.5.0

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
27
+ - Webhook-Endpunkt für Echtzeit-Updates — per AgentDVR-Action aufrufbar, löst sofortigen vollständigen Poll aus
23
28
  - HTML-Galerie-Widget pro Kamera (reines HTML/CSS oder JS-Modus mit Suche und Tag-Filter)
24
29
  - Übersichts-Widget, das alle Kameras in einem HTML-Zustand kombiniert
25
30
  - **Eingebautes Live-Dashboard** unter `http://<iobroker>:<webport>/agent-dvr/` — 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
 
@@ -198,11 +214,18 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
198
214
 
199
215
  **Funktionen:**
200
216
  - 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
217
+ - 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
218
  - Vollbildansicht mit PTZ-Overlay, Aufnahme-, Ton- und nativer Browser-Vollbild-Schaltfläche; Header blendet sich nach 3 s Inaktivität aus
203
219
  - Echtzeit-Bewegungs- (gelber Rahmen) und Alarm-Indikatoren (oranger Rahmen) via Socket.io
204
220
  - 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
221
+ - Aufnahmen-Tab mit Raster-, Timeline- und Ereignisprotokoll-Ansicht, Suche, ausklappbarem Tag-Filter und Video-Player mit Vor-/Zurück-Navigation
222
+ - Tag-Filter splittet AgentDVRs kommagetrennte Tags in einzelne Chips — jeder Tag einzeln filterbar
223
+ - Aufnahme löschen aus dem Video-Player-Modal oder per Mehrfachauswahl (Langer Druck → Checkbox-Modus, Sammel-Löschen, ab AgentDVR v7.7.8.0+)
224
+ - 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
225
+ - „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)
226
+ - Kamerafarben werden aus AgentDVR gelesen und für Timeline-Balken und Aufnahme-Punkte verwendet
227
+ - PTZ-Presets — gespeicherte Positionen im PTZ-Overlay anzeigen und anfahren; ein Selektor-Datenpunkt pro Kamera (ab AgentDVR v7.7.8.0+)
228
+ - Statuszeile zeigt Kameraanzahl, CPU-/RAM-Auslastung und freien Festplattenspeicher
206
229
  - Farbdesign über die Adapter-Konfiguration einstellbar
207
230
 
208
231
  ### go2rtc WebRTC-Streams
@@ -215,6 +238,34 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
215
238
  3. Die **go2rtc-URL** eintragen, die unterhalb der Tabelle erscheint (z. B. `http://192.168.1.10:1984`).
216
239
  4. Speichern und Adapter neu starten. Der Adapter proxied den WebSocket-Traffic über ioBroker, um Browser-CORS-Probleme zu umgehen.
217
240
 
241
+ ## Medien-Proxy
242
+
243
+ 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".
244
+
245
+ | Was wird geleitet | Proxy aus | Proxy an |
246
+ |-------------------|-----------|----------|
247
+ | MJPEG-Livestream | direkte AgentDVR-URL | `/agent-dvr/api/mjpeg?oid=…` |
248
+ | Snapshot | direkte AgentDVR-URL | `/agent-dvr/api/snap?oid=…` |
249
+ | Aufnahmen-Vorschaubilder | direkte AgentDVR-URL | `/agent-dvr/api/thumb?oid=…` |
250
+ | Aufnahmen-Videos | direkte AgentDVR-URL | `/agent-dvr/api/media?oid=…` |
251
+ | FLV-Livestream | **immer über ioBroker** | **immer über ioBroker** |
252
+ | go2rtc-WebSocket | **immer über ioBroker** | **immer über ioBroker** |
253
+
254
+ 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).
255
+
256
+ ### Wann einschalten
257
+
258
+ - Du rufst das Dashboard von außerhalb deines Heimnetzes auf, wo AgentDVR vom Browser aus nicht direkt erreichbar ist
259
+ - Nur ioBroker ist nach außen erreichbar (z. B. über einen Reverse-Proxy oder VPN nur zu ioBroker)
260
+
261
+ ### Wann ausgelassen lassen
262
+
263
+ - Browser und AgentDVR sind im gleichen Netzwerk (lokaler Zugriff)
264
+ - Direktverbindung ist schneller — kein Umweg, geringere Latenz
265
+ - Weniger Last auf dem ioBroker-Server — Streams müssen nicht durch Node.js laufen
266
+
267
+ > Die Einstellung wird sofort nach dem Speichern wirksam — kein Neustart erforderlich.
268
+
218
269
  ## Datenpunkte
219
270
 
220
271
  `<cam>` steht für `cam_<oid>_<name>`, z. B. `cam_8_Reolink`.
@@ -307,6 +358,7 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
307
358
  | `<cam>.control.ptz.zoomOut` | Schalter | R/W | Herauszoomen |
308
359
  | `<cam>.control.ptz.stop` | Taste | W | PTZ-Bewegung stoppen |
309
360
  | `<cam>.control.ptz.center` | Taste | W | Mitte-/Ausgangsposition anfahren |
361
+ | `<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
362
 
311
363
  ### Stream-URLs *(erfordert „Stream-URLs generieren")*
312
364
 
@@ -324,9 +376,20 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
324
376
  | Datenpunkt | Typ | R/W | Beschreibung |
325
377
  |-----------|-----|-----|-------------|
326
378
  | `<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
379
  | `<cam>.gallery` | string | R | HTML-Aufnahmegalerie — erfordert „Galerie-Widget" |
329
380
 
381
+ ## Webhook
382
+
383
+ Der Adapter stellt einen Webhook-Endpunkt bereit, der einen sofortigen vollständigen Poll auslöst:
384
+
385
+ ```
386
+ GET http://<iobroker>:<webport>/agent-dvr/webhook
387
+ ```
388
+
389
+ 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.
390
+
391
+ Gibt `{"ok":true}` bei Erfolg zurück.
392
+
330
393
  ### Übersicht *(erfordert „Übersichts-Widget")*
331
394
 
332
395
  | Datenpunkt | Typ | R/W | Beschreibung |
@@ -339,6 +402,39 @@ Das eingebaute Live-Dashboard ist erreichbar unter `http://<iobroker>:<webport>/
339
402
  Placeholder for the next version (at the beginning of the line):
340
403
  ### **WORK IN PROGRESS**
341
404
  -->
405
+ ### 0.5.0 (2026-08-03)
406
+ * (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
407
+ * (ipod86) feat: Neue-Aufnahmen-Badge am Aufnahmen-Tab — zeigt Anzahl neuer Aufnahmen seit letztem Besuch; browser- und gerätebezogen im localStorage gespeichert
408
+ * (ipod86) feat: Aufnahmen-Anzeigeeinstellungen — ⚙ Zahnrad im Auswahl-/Löschen-Balken; Schieberegler für Rasterspaltengröße, maximale Aufnahmen und Badge-Toggle (alles im localStorage)
409
+ * (ipod86) feat: Erstbesuchs-Hinweis-Modals für Live-Ansicht (Filter & Sortierung) und Aufnahmen-Tab (Gesten, Zahnrad, Badge)
410
+ * (ipod86) feat: Webhook-Endpunkt `/agent-dvr/webhook` löst sofortigen vollständigen Poll aus — als AgentDVR-Action konfigurierbar für Echtzeit-Updates
411
+ * (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+)
412
+ * (ipod86) feat: Ereignisprotokoll-Ansicht im Aufnahmen-Bereich (Uhr-Icon neben Raster und Timeline)
413
+ * (ipod86) feat: Aufnahme löschen direkt aus dem Video-Player-Modal (Papierkorb, 2-Klick-Bestätigung, ab AgentDVR v7.7.8.0+)
414
+ * (ipod86) feat: Mehrfachauswahl im Aufnahmen-Bereich — langer Druck aktiviert Checkbox-Modus, Sammel-Löschen und „Alle auswählen"-Schaltfläche
415
+ * (ipod86) feat: neue Einstellung `dashMaxRec` — begrenzt die Gesamtanzahl Aufnahmen im Dashboard über alle Kameras (unabhängig vom Widget-Limit, Standard 200)
416
+ * (ipod86) feat: Tag-Filter splittet kommagetrennte Tags in einzelne Chips für kameraübergreifende Filterung pro Tag
417
+ * (ipod86) feat: Kamerafarbe aus AgentDVR lesen und für Timeline-Balken und Aufnahme-Punkte verwenden
418
+ * (ipod86) feat: Statuszeile zeigt CPU-Auslastung, RAM-% und freien Speicher sowie freien Festplattenspeicher
419
+ * (ipod86) feat: Farben-auf-Werkseinstellung-Schaltfläche im Tab „Live-Dashboard" der Adapter-Einstellungen
420
+ * (ipod86) refactor: pro-Kamera pushTrigger-Datenpunkte durch globalen Webhook ersetzt
421
+ * (ipod86) fix: Neue-Aufnahmen-Badge jetzt korrekt sichtbar (display:none CSS-Fallback behoben)
422
+ * (ipod86) fix: Aufnahme-Schaltfläche an die rechteste Position in Raster-Kacheln und Vollbild-Panel verschoben
423
+ * (ipod86) fix: Kamera-Filter-Button ändert sein Aussehen nicht mehr wenn Kameras ausgeblendet sind
424
+ * (ipod86) fix: Header-Z-Index angehoben, damit das Filter-Popover über dem Hauptinhalt gerendert wird
425
+ * (ipod86) fix: Pruning-Regex für Drive-Objekte korrigiert; veraltete Drive-Einträge werden jetzt korrekt entfernt
426
+ * (ipod86) fix: gelöschte Aufnahmen erscheinen nach dem nächsten Adapter-Poll nicht mehr erneut
427
+ * (ipod86) fix: Videofehler-Hinweis um AgentDVR-Auto-Konvertierungs-Hinweis in allen 11 Sprachen erweitert
428
+ * (ipod86) fix: FLV-Stream- und Raster-Kachel-Skalierung korrigiert
429
+ * (ipod86) fix: Apostroph im italienischen i18n-String hat die gesamte Seiten-JS gebrochen
430
+ * (ipod86) fix: AgentDVR-Antwort „Command not found" beim Löschen wird jetzt erkannt und als Fehler angezeigt
431
+
432
+ ### 0.4.3 (2026-07-19)
433
+ * (ipod86) fix: Poll-Schleife von setInterval auf setTimeout umgestellt (verhindert parallele Polls)
434
+ * (ipod86) fix: httpTimeoutMs=0 wird jetzt korrekt auf 1000 ms geclampt statt auf Standardwert zu fallen
435
+ * (ipod86) fix: go2rtcEnabled-Flag wird in fetchGo2rtcStreams jetzt berücksichtigt
436
+ * (ipod86) fix: nicht verwendeter isSupportedLang-Export aus widget-i18n entfernt
437
+
342
438
  ### 0.4.2 (2026-07-12)
343
439
  * (ipod86) fix: FLV-Stream-Proxy sendet jetzt Authorization-Header (HTTP 401 bei AgentDVR-Auth)
344
440
  * (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
32
+ - Webhook endpoint for real-time updates — call it from an AgentDVR action to trigger an immediate full poll
28
33
  - HTML gallery widget per camera (pure HTML/CSS or full JS mode with search and tag filter)
29
34
  - Overview widget combining all cameras in one HTML state
30
35
  - **Built-in live dashboard** at `http://<iobroker>:<webport>/agent-dvr/` — 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
 
@@ -203,11 +219,18 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
203
219
 
204
220
  **Features:**
205
221
  - 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)
222
+ - 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
223
+ - 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
224
  - Real-time motion (yellow border) and alert (orange border) indicators via Socket.io
209
225
  - 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
226
+ - Recordings tab with grid, timeline, and event log view, search, collapsible tag filter, and video player with prev/next navigation
227
+ - Tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
228
+ - Delete recording from the video player modal or select multiple with a long-press and bulk-delete (requires AgentDVR v7.7.8.0+)
229
+ - 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
230
+ - 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)
231
+ - Camera colors are read from AgentDVR and applied to timeline bars and recording dots
232
+ - PTZ presets — navigate to saved presets from the PTZ overlay; single selector data point per camera (requires AgentDVR v7.7.8.0+)
233
+ - Status bar shows camera count, CPU/RAM usage and disk free space
211
234
  - Color theming via adapter config
212
235
 
213
236
  ### go2rtc WebRTC Streams
@@ -220,6 +243,34 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
220
243
  3. Enter the **go2rtc URL** that appears below the table (e.g. `http://192.168.1.10:1984`).
221
244
  4. Save and restart. The adapter proxies WebSocket traffic through ioBroker to avoid browser cross-origin restrictions.
222
245
 
246
+ ## Media Proxy
247
+
248
+ 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.
249
+
250
+ | What is proxied | Proxy off | Proxy on |
251
+ |-----------------|-----------|----------|
252
+ | MJPEG live stream | direct AgentDVR URL | `/agent-dvr/api/mjpeg?oid=…` |
253
+ | Snapshot | direct AgentDVR URL | `/agent-dvr/api/snap?oid=…` |
254
+ | Recording thumbnails | direct AgentDVR URL | `/agent-dvr/api/thumb?oid=…` |
255
+ | Recording videos | direct AgentDVR URL | `/agent-dvr/api/media?oid=…` |
256
+ | FLV live stream | **always via ioBroker** | **always via ioBroker** |
257
+ | go2rtc WebSocket | **always via ioBroker** | **always via ioBroker** |
258
+
259
+ FLV and go2rtc always run through ioBroker regardless of the setting — the browser cannot make cross-origin requests to these endpoints directly.
260
+
261
+ ### When to enable
262
+
263
+ - You access the dashboard from outside your home network where AgentDVR is not directly reachable from the browser
264
+ - Only ioBroker is exposed externally (e.g. via reverse proxy or VPN to ioBroker only)
265
+
266
+ ### When to leave it off
267
+
268
+ - Browser and AgentDVR are on the same network (local access)
269
+ - Direct connection is faster — no extra hop, lower latency
270
+ - Less load on the ioBroker server — streams do not pass through Node.js
271
+
272
+ > The setting takes effect immediately after saving — no restart required.
273
+
223
274
  ## Data points
224
275
 
225
276
  `<cam>` stands for `cam_<oid>_<name>`, e.g. `cam_8_Reolink`.
@@ -312,6 +363,7 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
312
363
  | `<cam>.control.ptz.zoomOut` | switch | R/W | Zoom out |
313
364
  | `<cam>.control.ptz.stop` | button | W | Stop PTZ movement |
314
365
  | `<cam>.control.ptz.center` | button | W | Move to center/home position |
366
+ | `<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
367
 
316
368
  ### Stream URLs *(requires "Generate stream URLs")*
317
369
 
@@ -329,9 +381,20 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
329
381
  | Data point | Type | R/W | Description |
330
382
  |-----------|------|-----|-------------|
331
383
  | `<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
384
  | `<cam>.gallery` | string | R | HTML recording gallery — requires "Gallery widget" |
334
385
 
386
+ ## Webhook
387
+
388
+ The adapter exposes a webhook endpoint that triggers an immediate full poll of AgentDVR:
389
+
390
+ ```
391
+ GET http://<iobroker>:<webport>/agent-dvr/webhook
392
+ ```
393
+
394
+ 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.
395
+
396
+ Returns `{"ok":true}` on success.
397
+
335
398
  ### Overview *(requires "Overview widget")*
336
399
 
337
400
  | Data point | Type | R/W | Description |
@@ -339,11 +402,39 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
339
402
  | `overview` | string | R | HTML tile grid of all cameras |
340
403
 
341
404
  ## Changelog
405
+ ### 0.5.0 (2026-08-03)
406
+ * (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
407
+ * (ipod86) feat: new-recordings badge on the Recordings tab — shows count of recordings since last visit; persisted per browser/device in localStorage
408
+ * (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)
409
+ * (ipod86) feat: first-visit onboarding modals for live view (camera filter & sort) and recordings tab (gestures, gear panel, badge)
410
+ * (ipod86) feat: webhook endpoint `/agent-dvr/webhook` triggers immediate full poll — configure as AgentDVR action for real-time updates
411
+ * (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+)
412
+ * (ipod86) feat: add event log view to recordings panel (clock icon toggle) alongside grid and timeline
413
+ * (ipod86) feat: delete recording from video modal (trash icon, two-click confirm, requires AgentDVR v7.7.8.0+)
414
+ * (ipod86) feat: bulk-delete recordings — long-press a tile to enter select mode, checkbox each recording, delete all at once
415
+ * (ipod86) feat: new `dashMaxRec` config setting — limits total recordings shown across all cameras in the dashboard (independent of widget limit, default 200)
416
+ * (ipod86) feat: tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
417
+ * (ipod86) feat: read camera color from AgentDVR and use it for timeline bars and recording dots
418
+ * (ipod86) feat: status bar shows CPU usage, RAM % and free, disk usage % and free alongside camera/recording counts
419
+ * (ipod86) feat: reset colors to defaults button in Live Dashboard settings tab
420
+ * (ipod86) refactor: remove per-camera pushTrigger data points in favour of the global webhook
421
+ * (ipod86) fix: new-recordings badge now correctly visible (display:none CSS fallback fixed)
422
+ * (ipod86) fix: record button moved to rightmost position in grid tiles and fullscreen panel
423
+ * (ipod86) fix: camera filter button no longer changes appearance when cameras are hidden
424
+ * (ipod86) fix: header z-index lifted so the camera filter popover renders above the main content area
425
+ * (ipod86) fix: drive object pruning regex corrected; stale drive entries are now properly removed
426
+ * (ipod86) fix: deleted recordings no longer reappear after the next adapter poll
427
+ * (ipod86) fix: extend video format error message with AgentDVR auto-convert hint in all 11 languages
428
+ * (ipod86) fix: FLV stream and grid tile layout scaling corrections
429
+ * (ipod86) fix: Italian i18n string with apostrophe broke page JS (changed to escaped variant)
430
+ * (ipod86) fix: detect AgentDVR "Command not found" response on delete and show proper error message
431
+
432
+ ### 0.4.3 (2026-07-19)
433
+ * (ipod86) fix: switch polling loop from setInterval to setTimeout to prevent concurrent poll runs
434
+ * (ipod86) fix: httpTimeoutMs=0 now correctly clamps to 1000ms instead of falling back to default
435
+ * (ipod86) fix: go2rtcEnabled config flag is now honored in fetchGo2rtcStreams
436
+ * (ipod86) fix: remove unused isSupportedLang export from widget-i18n
342
437
 
343
- <!--
344
- Placeholder for the next version (at the beginning of the line):
345
- ### **WORK IN PROGRESS**
346
- -->
347
438
  ### 0.4.2 (2026-07-12)
348
439
  * (ipod86) fix: FLV stream proxy now sends Authorization header (HTTP 401 with AgentDVR auth)
349
440
  * (ipod86) fix: dashboard camera online status was read from wrong state path (data.online → status.online)
@@ -370,32 +461,6 @@ The adapter ships a built-in live dashboard at `http://<iobroker>:<webport>/agen
370
461
  * (ipod86) feat: live view modal header auto-hides after 3 s of inactivity; reappears on mouse/touch
371
462
  * (ipod86) fix: add fsEnter, fsExit, filterByLabel, timelineView, closePanel i18n keys in all 10 languages
372
463
 
373
- ### 0.2.2 (2026-07-04)
374
- * (ipod86) fix: translate remaining German strings in DashboardPanel to English via I18n.t()
375
- * (ipod86) fix: add i18n keys loadingCamerasAndStreams, cfgCameraColumn, cfgStreamSourceColumn, reload in all 11 languages
376
- * (ipod86) chore: replace POSIX mv with cross-platform node rename in src-admin build script
377
-
378
- ### 0.2.1 (2026-07-04)
379
- * (ipod86) fix: translate all German user-facing strings and error messages to English
380
- * (ipod86) fix: DashboardPanel shows i18n-aware messages for missing IP and empty camera list
381
- * (ipod86) chore: add .npmignore to exclude src/ and src-admin/ from npm package
382
-
383
- ### 0.2.0 (2026-07-04)
384
- * (ipod86) feat: dashboard camera filter badges with localStorage persistence
385
- * (ipod86) feat: FLV/MP4 stream auto-reconnect after network error (5 s delay)
386
- * (ipod86) feat: go2rtc WebSocket auto-reconnect after unexpected disconnect (5 s delay)
387
- * (ipod86) feat: go2rtc stall detection — retry if stream stays black after 10 s
388
- * (ipod86) fix: cameraStreams missing from io-package.json native defaults (settings not saved)
389
- * (ipod86) fix: adminUI.config "custom" → "materialize" (404 on adapter settings page)
390
- * (ipod86) fix: remove resolution overlay on FLV stream load
391
- * (ipod86) fix: remove CDN fallback for flv.js — local copy only
392
- * (ipod86) fix: remove AgentDVR/go2rtc section headers from dashboard grid
393
- * (ipod86) fix: cfgGo2rtcMapping_tt tooltip corrected in all 11 languages
394
- * (ipod86) fix: plain setTimeout() replaced by this.setTimeout() (E5005)
395
- * (ipod86) fix: remove obsolete jsonConfig.json — settings handled by React admin (W5046)
396
- * (ipod86) chore: exclude admin/ directory from ESLint to prevent OOM in CI
397
- * (ipod86) docs: rewrite README and README.de with all tabs and settings documented
398
-
399
464
  [Older changelog entries in CHANGELOG_OLD.md](CHANGELOG_OLD.md)
400
465
 
401
466
  ## License