iobroker.agent-dvr 0.9.0 → 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 |
@@ -528,7 +555,7 @@ sendTo('agent-dvr.0', 'sendRecording', {
528
555
  });
529
556
  ```
530
557
 
531
- Die Nachricht an das Ziel ist `{ text: 'iobfile://agent-dvr.0/<cam>/<datei>', type: 'video', fileName: '<name>.mp4', caption, user, chatId }` — Telegram ab Version 6 liest die Datei selbst aus dem Dateispeicher. Andere Ziele bekommen stattdessen den absoluten Dateipfad (bzw. die URI, wenn der Dateispeicher nicht auf der lokalen Platte liegt). Die Antwort ist `{ ok, error?, fileName, format, mime, size, uri, url, file }`. **Telegram-Bots können nur Dateien bis 50 MB senden**; größere Aufnahmen werden mit einer klaren Fehlermeldung abgelehnt — schon vor dem Download, wenn AgentDVR die Größe bereits listet.
558
+ Die Nachricht an das Ziel ist `{ text: 'iobfile://agent-dvr.0/<cam>/<datei>', type: 'video', fileName: '<name>.mp4', width, height, duration, caption, user, chatId }` — Telegram ab Version 6 liest die Datei selbst aus dem Dateispeicher. `width`, `height` und `duration` liest der Adapter aus der Videodatei: Telegram erkennt sie bei größeren Bot-Uploads nicht selbst und zeigt das Video im Chat sonst bis zum Öffnen im falschen Seitenverhältnis. Andere Ziele bekommen stattdessen den absoluten Dateipfad (bzw. die URI, wenn der Dateispeicher nicht auf der lokalen Platte liegt). Die Antwort ist `{ ok, error?, fileName, format, mime, size, uri, url, file, width, height, duration }`. Eine Aufnahme, die AgentDVR noch schreibt, wird verschickt, sobald sie fertig ist. **Telegram-Bots können nur Dateien bis 50 MB senden**; größere Aufnahmen werden mit einer klaren Fehlermeldung abgelehnt — schon vor dem Download, wenn AgentDVR die Größe bereits listet.
532
559
 
533
560
  > **Über den ioBroker-Nachrichtenbus gehen keine Videodaten.** Große Nachrichten (zig MB) können die States-DB und damit den ganzen ioBroker blockieren. Deshalb gibt der Adapter nur den Dateiverweis weiter und verweigert jede Nachricht oder Antwort mit Binärdaten.
534
561
 
@@ -540,9 +567,17 @@ on({ id: 'agent-dvr.0.cam_8_Reolink.events.new', val: true }, () => {
540
567
  });
541
568
  ```
542
569
 
543
- Ist der Dateispeicher eingeschaltet, stattdessen auf `recordings.ts1` triggern und die gespeicherte Kopie senden (`recording: 1`) — oder Telegram ab 6 liest sie selbst: `sendTo('telegram.0', { text: getState('agent-dvr.0.cam_8_Reolink.recordings.uri1').val, type: 'video' })`.
570
+ Ist der Dateispeicher eingeschaltet, stattdessen auf `recordings.ts1` triggern und die gespeicherte Kopie senden (`recording: 1`):
544
571
 
545
- `getRecording` nimmt dieselben `camera`, `recording` und `mp4`, stellt die Aufnahme genauso bereit und liefert nur, wo sie liegt: `{ ok, error?, fileName, mime, format, size, uri, url, file }`. Die Datei liest das Skript selbst, z. B.:
572
+ ```js
573
+ on({ id: 'agent-dvr.0.cam_8_Reolink.recordings.ts1', change: 'ne', ack: true }, () => {
574
+ sendTo('agent-dvr.0', 'sendRecording', { camera: 'cam_8_Reolink', recording: 1, target: 'telegram.0', caption: 'Neue Aufnahme' });
575
+ });
576
+ ```
577
+
578
+ > **Tipp: das richtige Seitenverhältnis im Chat.** Schickst du die Videodatei selbst an Telegram (Telegram-Block in Blockly, `recordings.file1`/`uri1`), zeigt Telegram größere Videos in der Chat-Vorschau oft im falschen Format (z. B. 3:4), bis man sie öffnet — Telegram liest die Bildgröße bei größeren Bot-Uploads nicht selbst aus. `sendRecording` liest Breite, Höhe und Dauer aus der Videodatei und gibt sie mit, so läuft das Video im Chat sofort im Seitenverhältnis der Kamera. Nichts einzustellen — es klappt einfach, wenn du `sendRecording` nimmst.
579
+
580
+ `getRecording` nimmt dieselben `camera`, `recording` und `mp4`, stellt die Aufnahme genauso bereit und liefert nur, wo sie liegt: `{ ok, error?, fileName, mime, format, size, uri, url, file, width, height, duration }`. Die Datei liest das Skript selbst, z. B.:
546
581
 
547
582
  ```js
548
583
  sendTo('agent-dvr.0', 'getRecording', { camera: 'cam_8_Reolink', recording: 'last' }, res => {
@@ -615,6 +650,17 @@ z. B. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (ebe
615
650
  Placeholder for the next version (at the beginning of the line):
616
651
  ### **WORK IN PROGRESS**
617
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
+
659
+ ### 0.9.1 (2026-11-13)
660
+ * (ipod86) fix: Aufnahmen wurden gespeichert, während AgentDVR sie noch schrieb (Video abgeschnitten) — der Adapter wartet jetzt, bis die Aufnahme fertig ist
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
662
+ * (ipod86) feat: Nachrichten `getCameras` und `getWidgets` für die Web-Komponenten (Vorbereitung für Auswahllisten statt Objektbaum)
663
+
618
664
  ### 0.9.0 (2026-11-12)
619
665
  * (ipod86) feat: die letzten 1–3 Aufnahmen pro Kamera im ioBroker-Dateispeicher (`recordings.file/uri/url/name/ts`), auf Wunsch als MP4 über ffmpeg
620
666
  * (ipod86) feat: `sendRecording` / `getRecording` schicken eine Aufnahme als Video an Telegram oder stellen sie als Datei für Skripte bereit
@@ -624,10 +670,10 @@ z. B. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (ebe
624
670
 
625
671
  ### 0.8.1 (2026-11-12)
626
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“
627
- * (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
628
674
 
629
675
  ### 0.8.0 (2026-11-12)
630
- * (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
631
677
 
632
678
  ### 0.7.0 (2026-10-29)
633
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 |
@@ -533,7 +560,7 @@ sendTo('agent-dvr.0', 'sendRecording', {
533
560
  });
534
561
  ```
535
562
 
536
- The message to the target is `{ text: 'iobfile://agent-dvr.0/<cam>/<file>', type: 'video', fileName: '<name>.mp4', caption, user, chatId }` — Telegram 6 and newer reads the file itself from the file storage. Other targets get the absolute file path instead (or the URI if the file storage is not on the local disk). The answer is `{ ok, error?, fileName, format, mime, size, uri, url, file }`. **Telegram bots can only send files up to 50 MB**; larger recordings are rejected with a clear error — before downloading when AgentDVR already lists the size.
563
+ The message to the target is `{ text: 'iobfile://agent-dvr.0/<cam>/<file>', type: 'video', fileName: '<name>.mp4', width, height, duration, caption, user, chatId }` — Telegram 6 and newer reads the file itself from the file storage. `width`, `height` and `duration` are read from the video file: Telegram does not detect them itself for larger bot uploads and would otherwise show the video in the chat in a wrong aspect ratio until it is opened. Other targets get the absolute file path instead (or the URI if the file storage is not on the local disk). The answer is `{ ok, error?, fileName, format, mime, size, uri, url, file, width, height, duration }`. A recording AgentDVR is still writing is sent once it is finished. **Telegram bots can only send files up to 50 MB**; larger recordings are rejected with a clear error — before downloading when AgentDVR already lists the size.
537
564
 
538
565
  > **No video data goes over the ioBroker message bus.** Large messages (tens of MB) can block the states DB and with it the whole ioBroker. That is why the adapter passes only the file reference and refuses to send or answer anything that contains binary data.
539
566
 
@@ -545,9 +572,17 @@ on({ id: 'agent-dvr.0.cam_8_Reolink.events.new', val: true }, () => {
545
572
  });
546
573
  ```
547
574
 
548
- With the file storage feature enabled, trigger on `recordings.ts1` and send the stored copy instead (`recording: 1`) — or let Telegram 6+ read it itself: `sendTo('telegram.0', { text: getState('agent-dvr.0.cam_8_Reolink.recordings.uri1').val, type: 'video' })`.
575
+ With the file storage feature enabled, trigger on `recordings.ts1` and send the stored copy instead (`recording: 1`):
549
576
 
550
- `getRecording` takes the same `camera`, `recording` and `mp4`, makes the recording available the same way and returns only where it is: `{ ok, error?, fileName, mime, format, size, uri, url, file }`. Read the file in your script yourself, e.g.:
577
+ ```js
578
+ on({ id: 'agent-dvr.0.cam_8_Reolink.recordings.ts1', change: 'ne', ack: true }, () => {
579
+ sendTo('agent-dvr.0', 'sendRecording', { camera: 'cam_8_Reolink', recording: 1, target: 'telegram.0', caption: 'New recording' });
580
+ });
581
+ ```
582
+
583
+ > **Tip: the right aspect ratio in the chat.** If you send the video file to Telegram yourself (Telegram Blockly block, `recordings.file1`/`uri1`), Telegram often shows larger videos in the chat preview in a wrong format (e.g. 3:4) until you open them — Telegram does not read the picture size from larger bot uploads itself. `sendRecording` reads width, height and duration from the video file and passes them along, so the video plays in the chat right away in the camera's aspect ratio. Nothing to configure, it simply works when you use `sendRecording`.
584
+
585
+ `getRecording` takes the same `camera`, `recording` and `mp4`, makes the recording available the same way and returns only where it is: `{ ok, error?, fileName, mime, format, size, uri, url, file, width, height, duration }`. Read the file in your script yourself, e.g.:
551
586
 
552
587
  ```js
553
588
  sendTo('agent-dvr.0', 'getRecording', { camera: 'cam_8_Reolink', recording: 'last' }, res => {
@@ -615,6 +650,21 @@ http://<iobroker>:<webport>/agent-dvr.0/photos/<cam>/grab1.jpg
615
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.
616
651
 
617
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
+
663
+ ### 0.9.1 (2026-11-13)
664
+ * (ipod86) fix: recordings were stored while AgentDVR was still writing them (video cut off) — the adapter now waits until the recording is finished
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
666
+ * (ipod86) feat: messages `getCameras` and `getWidgets` for the web components (prepares dropdowns instead of the object browser)
667
+
618
668
  ### 0.9.0 (2026-11-12)
619
669
  * (ipod86) feat: keep the last 1–3 recordings per camera in the ioBroker file storage (`recordings.file/uri/url/name/ts`), optionally as MP4 via ffmpeg
620
670
  * (ipod86) feat: `sendRecording` / `getRecording` send a recording to Telegram as video or provide it as a file for scripts
@@ -624,26 +674,10 @@ e.g. `http://192.168.1.10:8082/agent-dvr.0/photos/cam_8_Reolink/grab1.jpg` (also
624
674
 
625
675
  ### 0.8.1 (2026-11-12)
626
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"
627
- * (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
628
678
 
629
679
  ### 0.8.0 (2026-11-12)
630
- * (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
631
-
632
- ### 0.7.0 (2026-10-29)
633
- * (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
634
- * (ipod86) feat: `<cam>.events.webhookParams` with all parameters of the latest webhook call as JSON
635
-
636
- <!-- markdownlint-disable-next-line MD024 -->
637
-
638
- ### 0.6.0 (2026-10-29)
639
- * (ipod86) chore: clearer adapter title ("Agent DVR – Cameras & Recordings") and keywords
640
- * (ipod86) fix: `events.detected_*` now also fires when AgentDVR adds the AI tag (e.g. `people`) to a recording after it was first listed
641
- * (ipod86) feat: webhook with `?oid={ID}&ot={OT}` pulses `<cam>.events.webhook` immediately (20 s cooldown per camera) for the fastest possible alert photo
642
- * (ipod86) feat: alert photos — on a webhook call with `oid` the full-resolution photo is stored in the file storage, last 3 per camera (`alertPhotos.grab1–3`, `ts1–3`)
643
- * (ipod86) feat: alert photos served for VIS at `/agent-dvr.0/photos/<cam>/grab1.jpg`; new README section on getting images for VIS and scripts
644
- * (ipod86) feat: `alertPhotos.uri1–3` with the `iobfile://` URI of each photo, sendable directly with Telegram 6
645
-
646
- <!-- 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
647
681
 
648
682
  [Older changelog entries in CHANGELOG_OLD.md](CHANGELOG_OLD.md)
649
683