iobroker.agent-dvr 0.9.1 → 0.10.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
@@ -18,8 +18,8 @@ Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): erkennt automati
18
18
 
19
19
  ## Highlights
20
20
 
21
- ### Web-Komponenten für AURA, vis-2 und devices
22
- Aufnahmen-Galerie, Live-Kachel und Live-Übersicht gibt es auch als Web-Komponenten (`@iobroker/web-components`). AURA (ab 0.106.0, empfohlen ab 0.112.0), vis-2 (ab 2.20.7) und der Geräte-Adapter devices (ab 4.3.0) bieten sie in ihrer Widget-Auswahl an – ohne HTML-Bindung. Sie zeichnen direkt im Browser statt die HTML-Datenpunkte anzuzeigen, ein Aktualisieren schließt daher nie einen offenen Player.
21
+ ### Widgets (Web-Komponenten) für AURA, vis-2, devices und andere Visualisierungen
22
+ Aufnahmen-Galerie, Live-Kachel und Live-Übersicht gibt es auch als Web-Komponenten (`@iobroker/web-components`). AURA (ab 0.106.0, empfohlen ab 0.112.0), vis-2 (ab 2.20.7), der Geräte-Adapter devices (ab 4.3.0) und jede andere Visualisierung, die Web-Komponenten unterstützt, bieten sie in ihrer Widget-Auswahl an – ohne HTML-Bindung. Sie zeichnen direkt im Browser statt die HTML-Datenpunkte anzuzeigen, ein Aktualisieren schließt daher nie einen offenen Player.
23
23
  - **Agent DVR Aufnahmen** – die Aufnahmen-Galerie einer Kamera, mit Suche und Tag-Filter, eingebautem Player oder externer Player-URL
24
24
  - **Agent DVR Live-Kamera** – die Live-Kachel einer Kamera; das Vorschaubild erneuert sich im Browser, ein Klick öffnet den Livestream
25
25
  - **Agent DVR Live-Übersicht** – die Live-Kacheln aller Kameras einer Instanz
@@ -27,6 +27,12 @@ Aufnahmen-Galerie, Live-Kachel und Live-Übersicht gibt es auch als Web-Komponen
27
27
  - übernimmt auf Wunsch die Farben aus dem Theme der Visualisierung
28
28
  - braucht keine Zugangsdaten: Bilder und Videos nutzen dieselben AgentDVR-Links wie die HTML-Widgets; die Daten kommen aus `widget_config` und `<cam>.widget_data`
29
29
 
30
+ ### Benachrichtigungen (Kamera offline, Person/Tier/Fahrzeug erkannt, neue Aufnahme)
31
+ - Eigener Reiter **Benachrichtigungen**: jede Art lässt sich einzeln einschalten – Kamera offline, Kamera wieder online, Agent-DVR-Server offline/online, Person, Tier, Fahrzeug oder sonstige Erkennung, neue Aufnahme – pro Kamera per Haken-Liste abschaltbar
32
+ - Die Benachrichtigungen gehen an das ioBroker-Benachrichtigungssystem (Glocke im Admin); der Adapter **notification-manager** leitet sie weiter, z. B. an Telegram oder E-Mail – im Adapter selbst muss kein Messenger eingerichtet werden
33
+ - **Kamera offline** wird gemeldet, wenn eine in Agent DVR eingeschaltete Kamera die eingestellte Zeit nicht verbunden ist (Standard 10 Minuten). Ohne Verbindung gibt es kein Bild und keine Bewegungserkennung; kurze Aussetzer wie ein Kamera-Neustart werden nicht gemeldet
34
+ - Neue Datenpunkte pro Kamera: `status.offlineSince` und `status.offlineAlarm` für eigene Skripte und Visualisierungen
35
+
30
36
  ### Aufnahmen im ioBroker-Dateispeicher und als Telegram-Video
31
37
  - **Letzte Aufnahmen im ioBroker-Dateispeicher bereitstellen** (standardmäßig aus): jede neue Aufnahme einer Kamera wird von AgentDVR geladen und pro Kamera als `rec1` … `rec3` abgelegt – mit Dateipfad, `iobfile://`-URI und http-URL in `<cam>.recordings.*`, genau wie die Alarmfotos
32
38
  - auf Wunsch als **MP4** (verlustfreies Umpacken mit ffmpeg, keine Neukodierung) – spielt überall, auch direkt in Telegram
@@ -231,6 +237,23 @@ Die go2rtc-Streamnamen werden automatisch vom go2rtc-Server abgerufen, wenn das
231
237
  | Modal-Hintergrund | Hintergrundfarbe des Video-Modals |
232
238
  | Border-Radius (px) | Abrundungsradius der Kartenecken | `4` |
233
239
 
240
+ ### Tab: Benachrichtigungen
241
+
242
+ Jeder Punkt ist optional und anfangs aus. Die Benachrichtigungen gehen an das ioBroker-Benachrichtigungssystem; den Adapter **notification-manager** installieren und dort bei *Agent DVR* wählen, wohin welche Art geht (Telegram, E-Mail, …).
243
+
244
+ | Einstellung | Beschreibung | Standard |
245
+ |-------------|-------------|---------|
246
+ | Kamera offline | Eine in Agent DVR eingeschaltete Kamera ist die eingestellte Zeit nicht verbunden | `nein` |
247
+ | Kamera wieder online | Nur nach einer Offline-Benachrichtigung, mit der Dauer des Ausfalls | `nein` |
248
+ | Agent-DVR-Server offline / wieder online | Der Agent-DVR-Server antwortet die eingestellte Zeit nicht | `nein` |
249
+ | Offline nach (Minuten) | Ausfalldauer, ab der gemeldet wird (1–1440) | `10` |
250
+ | Person / Tier / Fahrzeug erkannt | Erkennungs-Tags von Agent DVR (`people`, `dog_cat`, `vehicle`, …) | `nein` |
251
+ | Sonstige Erkennungen | Alle anderen Tags, z. B. von eigenen KI-Modellen (reine Bewegung `detected`, von Hand ausgelöst `trigger` und `timelapse` sind keine Erkennung und werden nicht gemeldet) | `nein` |
252
+ | Neue Aufnahme | Agent DVR hat eine neue Aufnahme gemacht | `nein` |
253
+ | Kameras | Liste aller Kameras mit Haken; Kameras ohne Haken senden keine Benachrichtigungen. Neue Kameras sind automatisch angehakt, Umbenennen in Agent DVR schadet nicht | alle angehakt |
254
+
255
+ Erkennungen und neue Aufnahmen brauchen *Ereignis-Datenpunkte* oder das Widget (Reiter Funktionen).
256
+
234
257
  ### Tab: Erweitert
235
258
 
236
259
  | Einstellung | Beschreibung | Standard |
@@ -345,8 +368,12 @@ Dieser Adapter speichert deine AgentDVR-Admin-Zugangsdaten und stellt `system.co
345
368
  | Datenpunkt | Typ | R/W | Beschreibung |
346
369
  |-----------|-----|-----|-------------|
347
370
  | `<cam>.name` | string | R | Kameraname |
348
- | `<cam>.data.online` | boolean | R | Kamera ist online |
371
+ | `<cam>.data.online` | boolean | R | Kamera ist in Agent DVR eingeschaltet |
349
372
  | `<cam>.data.connected` | boolean | R | Stream ist verbunden |
373
+ | `<cam>.status.online` | boolean | R | Kamera ist in Agent DVR eingeschaltet (sagt nichts über die Erreichbarkeit) |
374
+ | `<cam>.status.connected` | boolean | R | Kamera erreichbar: Agent DVR bekommt ihr Bild (Rolle `indicator.reachable`) |
375
+ | `<cam>.status.offlineSince` | number | R | Zeitpunkt, seit dem die Kamera nicht verbunden ist (leer, wenn verbunden) |
376
+ | `<cam>.status.offlineAlarm` | boolean | R | Länger als die eingestellte Zeit nicht verbunden (Reiter Benachrichtigungen) |
350
377
  | `<cam>.data.recording` | boolean | R | Nimmt gerade auf |
351
378
  | `<cam>.data.detected` | boolean | R | Bewegung/Objekt erkannt |
352
379
  | `<cam>.data.detectorActive` | boolean | R | Bewegungserkennung aktiv |
@@ -623,6 +650,12 @@ z. B. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (ebe
623
650
  Placeholder for the next version (at the beginning of the line):
624
651
  ### **WORK IN PROGRESS**
625
652
  -->
653
+ ### 0.10.0 (2026-11-16)
654
+ * (ipod86) Neu: Tab „Benachrichtigungen“ – Kamera offline/wieder online, Server offline, Erkennung von Person/Tier/Fahrzeug/Sonstigem, neue Aufnahme über das ioBroker-Benachrichtigungssystem (notification-manager), jeweils einzeln wählbar
655
+ * (ipod86) Neu: pro Kamera wählbar, welche benachrichtigt (Häkchenliste, bleibt beim Umbenennen in Agent DVR erhalten)
656
+ * (ipod86) Neu: `status.offlineSince` und `status.offlineAlarm` je Kamera
657
+ * (ipod86) Fix: `status.connected` hat jetzt die Rolle `indicator.reachable` (Kamera erreichbar), `status.online` bedeutet „in Agent DVR eingeschaltet“
658
+
626
659
  ### 0.9.1 (2026-11-13)
627
660
  * (ipod86) fix: Aufnahmen wurden gespeichert, während AgentDVR sie noch schrieb (Video abgeschnitten) — der Adapter wartet jetzt, bis die Aufnahme fertig ist
628
661
  * (ipod86) fix: `sendRecording` gibt Breite, Höhe und Dauer an Telegram mit — größere Videos wurden im Chat im falschen Seitenverhältnis gezeigt; `sendRecording`/`getRecording` warten außerdem, bis eine Aufnahme fertig ist
@@ -637,10 +670,10 @@ z. B. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (ebe
637
670
 
638
671
  ### 0.8.1 (2026-11-12)
639
672
  * (ipod86) fix: Live-Übersicht (Web-Komponente) passt ihre Kacheln an die Widget-Größe an (kein Scrollen, kein Leerraum); Option „An die Widget-Größe anpassen“
640
- * (ipod86) chore: Beschreibung und Suchbegriffe nennen die Widgets für vis-2 und AURA
673
+ * (ipod86) chore: Beschreibung und Suchbegriffe nennen die Widgets für vis-2, AURA und andere Visualisierungen
641
674
 
642
675
  ### 0.8.0 (2026-11-12)
643
- * (ipod86) feat: Web-Komponenten für AURA (ab 0.106.0), vis-2 (ab 2.20.7) und devices (ab 4.3.0) – Aufnahmen-Galerie, Live-Kachel und Live-Übersicht, mit den Widget-Einstellungen des Adapters oder eigenen
676
+ * (ipod86) feat: Widgets (Web-Komponenten) für AURA (ab 0.106.0), vis-2 (ab 2.20.7), devices (ab 4.3.0) und andere Visualisierungen – Aufnahmen-Galerie, Live-Kachel und Live-Übersicht, mit den Widget-Einstellungen des Adapters oder eigenen
644
677
 
645
678
  ### 0.7.0 (2026-10-29)
646
679
  * (ipod86) feat: `alertPhotos.url1–3` mit festem http(s)-Link zu jedem Foto, für TV-/Kiosk-Apps, die nur Web-Links annehmen; Web-Instanz wählbar, Links folgen Änderungen an den Web-Instanzen
package/README.md CHANGED
@@ -23,8 +23,8 @@ Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all
23
23
 
24
24
  ## Highlights
25
25
 
26
- ### Web components for AURA, vis-2 and devices
27
- The recordings gallery, the live tile and the live overview are also available as web components (`@iobroker/web-components`). AURA (0.106.0+, 0.112.0+ recommended), vis-2 (2.20.7+) and the devices adapter (4.3.0+) list them in their widget palette — no HTML binding needed. They draw natively in the browser instead of showing the HTML data points, so a refresh never closes an open player.
26
+ ### Widgets (web components) for AURA, vis-2, devices and other visualisations
27
+ The recordings gallery, the live tile and the live overview are also available as web components (`@iobroker/web-components`). AURA (0.106.0+, 0.112.0+ recommended), vis-2 (2.20.7+), the devices adapter (4.3.0+) and every other visualisation that supports web components list them in their widget palette — no HTML binding needed. They draw natively in the browser instead of showing the HTML data points, so a refresh never closes an open player.
28
28
  - **Agent DVR recordings** — the recordings gallery of a camera, with search and tag filter, built-in player or external player URL
29
29
  - **Agent DVR live camera** — the live tile of one camera; the snapshot refreshes in the browser, a click opens the live stream
30
30
  - **Agent DVR live overview** — the live tiles of all cameras of an instance
@@ -32,6 +32,12 @@ The recordings gallery, the live tile and the live overview are also available a
32
32
  - optionally takes the colors of the visualization's theme
33
33
  - needs no credentials: the images and videos use the same AgentDVR links as the HTML widgets; data comes from `widget_config` and `<cam>.widget_data`
34
34
 
35
+ ### Notifications (camera offline, person/animal/vehicle detected, new recording)
36
+ - A separate **Notifications** tab: every kind of notification can be switched on on its own — camera offline, camera online again, Agent DVR server offline/online, person, animal, vehicle or other detection, new recording — per camera switchable with a checkbox list
37
+ - Notifications go to the ioBroker notification system (bell in the admin); the **notification-manager** adapter forwards them, e.g. to Telegram or e-mail — no messenger settings in this adapter
38
+ - **Camera offline** is reported when a camera that is switched on in Agent DVR has not been connected for the set time (default 10 minutes). Without a connection there is no picture and no motion detection; short outages like a camera reboot are not reported
39
+ - New data points per camera: `status.offlineSince` and `status.offlineAlarm` for your own scripts and visualisations
40
+
35
41
  ### Recordings in the ioBroker file storage and as Telegram video
36
42
  - **Provide the last recordings in the ioBroker file storage** (off by default): every new recording of a camera is downloaded from AgentDVR and kept as `rec1` … `rec3` per camera — with file path, `iobfile://` URI and http URL in `<cam>.recordings.*`, just like the alert photos
37
43
  - optionally as **MP4** (lossless remux with ffmpeg, no re-encoding) — plays everywhere, also inline in Telegram
@@ -236,6 +242,23 @@ The go2rtc stream names are fetched automatically from the go2rtc server when th
236
242
  | Modal background | Video modal background |
237
243
  | Border radius (px) | Rounded corner radius for cards | `4` |
238
244
 
245
+ ### Tab: Notifications
246
+
247
+ Every point is optional and off by default. Notifications are sent to the ioBroker notification system; install the **notification-manager** adapter and choose there for *Agent DVR* where each kind goes (Telegram, e-mail, …).
248
+
249
+ | Setting | Description | Default |
250
+ |---------|-------------|---------|
251
+ | Camera offline | A camera switched on in Agent DVR has not been connected for the set time | `false` |
252
+ | Camera online again | Only after an offline notification, with the duration of the outage | `false` |
253
+ | Agent DVR server offline / online again | The Agent DVR server does not answer for the set time | `false` |
254
+ | Offline after (minutes) | Outage duration that is reported (1–1440) | `10` |
255
+ | Person / Animal / Vehicle detected | Detection tags of Agent DVR (`people`, `dog_cat`, `vehicle`, …) | `false` |
256
+ | Other detections | All other tags, e.g. from your own AI models (plain motion `detected`, manual `trigger` and `timelapse` are no detection and are not reported) | `false` |
257
+ | New recording | Agent DVR made a new recording | `false` |
258
+ | Cameras | List of all cameras with a checkbox; unchecked cameras send no notifications. New cameras are checked automatically; the setting survives renaming a camera | all checked |
259
+
260
+ Detections and new recordings need *Event data points* or the widget (tab Features).
261
+
239
262
  ### Tab: Advanced
240
263
 
241
264
  | Setting | Description | Default |
@@ -350,8 +373,12 @@ This adapter stores your AgentDVR admin credentials and exposes `system.control.
350
373
  | Data point | Type | R/W | Description |
351
374
  |-----------|------|-----|-------------|
352
375
  | `<cam>.name` | string | R | Camera name |
353
- | `<cam>.data.online` | boolean | R | Camera is online |
376
+ | `<cam>.data.online` | boolean | R | Camera is switched on in Agent DVR |
354
377
  | `<cam>.data.connected` | boolean | R | Stream is connected |
378
+ | `<cam>.status.online` | boolean | R | Camera is switched on in Agent DVR (says nothing about reachability) |
379
+ | `<cam>.status.connected` | boolean | R | Camera is reachable: Agent DVR receives its picture (role `indicator.reachable`) |
380
+ | `<cam>.status.offlineSince` | number | R | Time since when the camera is not connected (empty when connected) |
381
+ | `<cam>.status.offlineAlarm` | boolean | R | Not connected for longer than the set time (tab Notifications) |
355
382
  | `<cam>.data.recording` | boolean | R | Currently recording |
356
383
  | `<cam>.data.detected` | boolean | R | Motion/object detected |
357
384
  | `<cam>.data.detectorActive` | boolean | R | Motion detector enabled |
@@ -623,6 +650,16 @@ http://<iobroker>:<webport>/agent-dvr.0/photos/<cam>/grab1.jpg
623
650
  e.g. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (also `grab2.jpg`, `grab3.jpg`). Use it in an image widget and refresh it on changes of `alertPhotos.ts1`. The same applies when you push the link to a TV or another app: send it on `alertPhotos.ts1`, not on `events.webhook` — otherwise the app loads the previous photo. For a live image use `urls.snapshot` or `urls.photo` with a refresh interval.
624
651
 
625
652
  ## Changelog
653
+ <!--
654
+ Placeholder for the next version (at the beginning of the line):
655
+ ### **WORK IN PROGRESS**
656
+ -->
657
+ ### 0.10.0 (2026-11-16)
658
+ * (ipod86) feat: Notifications tab – camera offline/online again, server offline, person/animal/vehicle/other detection, new recording via the ioBroker notification system (notification-manager), each optional
659
+ * (ipod86) feat: choose per camera which ones send notifications (checkbox list, survives renaming in Agent DVR)
660
+ * (ipod86) feat: `status.offlineSince` and `status.offlineAlarm` per camera
661
+ * (ipod86) fix: `status.connected` now has the role `indicator.reachable` (camera reachable), `status.online` means "switched on in Agent DVR"
662
+
626
663
  ### 0.9.1 (2026-11-13)
627
664
  * (ipod86) fix: recordings were stored while AgentDVR was still writing them (video cut off) — the adapter now waits until the recording is finished
628
665
  * (ipod86) fix: `sendRecording` passes width, height and duration to Telegram — larger videos were shown in a wrong aspect ratio in the chat; `sendRecording`/`getRecording` also wait until a recording is finished
@@ -637,16 +674,10 @@ e.g. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (also
637
674
 
638
675
  ### 0.8.1 (2026-11-12)
639
676
  * (ipod86) fix: live overview web component fits its tiles to the widget size (no scrolling, no empty space); option "Fit to the widget size"
640
- * (ipod86) chore: description and keywords mention the widgets for vis-2 and AURA
677
+ * (ipod86) chore: description and keywords mention the widgets for vis-2, AURA and other visualisations
641
678
 
642
679
  ### 0.8.0 (2026-11-12)
643
- * (ipod86) feat: web components for AURA (0.106.0+), vis-2 (2.20.7+) and devices (4.3.0+) – recordings gallery, live tile and live overview, with the adapter's widget settings or own ones
644
-
645
- ### 0.7.0 (2026-10-29)
646
- * (ipod86) feat: `alertPhotos.url1–3` with a fixed http(s) link to each photo, for TV/kiosk apps that only accept web links; web instance selectable, links follow changes of the web instances
647
- * (ipod86) feat: `<cam>.events.webhookParams` with all parameters of the latest webhook call as JSON
648
-
649
- <!-- markdownlint-disable-next-line MD024 -->
680
+ * (ipod86) feat: widgets (web components) for AURA (0.106.0+), vis-2 (2.20.7+), devices (4.3.0+) and other visualisations – recordings gallery, live tile and live overview, with the adapter's widget settings or own ones
650
681
 
651
682
  [Older changelog entries in CHANGELOG_OLD.md](CHANGELOG_OLD.md)
652
683