iobroker.agent-dvr 0.0.2 → 0.0.4

package/README.de.md

@@ -0,0 +1,198 @@
+![Logo](admin/agent-dvr.png)
+# ioBroker.agent-dvr
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.agent-dvr.svg)](https://www.npmjs.com/package/iobroker.agent-dvr)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.agent-dvr.svg)](https://www.npmjs.com/package/iobroker.agent-dvr)
+![Number of Installations](https://iobroker.live/badges/agent-dvr-installed.svg)
+![Current version in stable repository](https://iobroker.live/badges/agent-dvr-stable.svg)
+
+**Tests:** ![Test and Release](https://github.com/ipod86/ioBroker.agent-dvr/workflows/Test%20and%20Release/badge.svg)
+
+## agent-dvr Adapter für ioBroker
+
+Verbindet ioBroker mit [AgentDVR](https://www.ispyconnect.com): Kameras und Mikrofone werden automatisch erkannt, alle Gerätewerte als Datenpunkte gespiegelt, Steuerbefehle (Aufnahme, Arm/Disarm, PTZ, …) als Buttons bereitgestellt und neue Aufnahmen per Push-Trigger sofort gemeldet. Pro Kamera wird eine responsive HTML-Galerie mit optionalem Such- und Tag-Filter erzeugt.
+
+## Funktionen
+
+- Automatische Erkennung aller AgentDVR-Kameras und -Mikrofone beim Start
+- Alle Geräteeigenschaften als flache Datenpunkte (aus der API gespiegelt)
+- Steuerbuttons pro Gerät: Aufnahme, Snapshot, Erkennung, Alarm ein/aus, Gerät ein/aus, Objekterkennung, Ordner leeren, …
+- Systemweite Buttons: Arm, Disarm, alle ein/aus, Konfiguration neu laden, Speicherverwaltung, Neustart, …
+- **Profil-Selektor** — beschreibbarer Dropdown mit dem aktuell aktiven AgentDVR-Profil (Home / Away / Night / benutzerdefiniert); Änderungen werden sofort übernommen
+- **Snapshot als Base64** — State `snapshot_b64` (Rolle `media.picture`) pro Kamera, manuell per Button abrufbar oder automatisch bei jedem Poll aktualisiert
+- PTZ-Steuerung mit Hold-Switches (links, rechts, oben, unten, Diagonalen, Zoom ein/aus, Stop, Mitte)
+- Stream-URLs pro Kamera (Snapshot, Foto, MJPEG, MP4)
+- Push-Trigger — ioBroker-Skripte reagieren sofort wenn AgentDVR eine neue Aufnahme meldet
+- HTML-Galerie-Widget pro Kamera (reines HTML/CSS oder JS-Modus mit Suche und Tag-Filter)
+- Übersichts-Widget mit allen Kameras in einem HTML-State
+- Rohdaten-JSON-State für fortgeschrittene Anwendungsfälle
+
+## Konfiguration
+
+| Einstellung | Beschreibung | Standard |
+|-------------|-------------|---------|
+| AgentDVR IP | IP-Adresse des AgentDVR-Servers | — |
+| Port | AgentDVR-Port | `8090` |
+| Benutzername / Passwort | Optionale HTTP-Basic-Authentifizierung | — |
+| Abfrageintervall (s) | Wie oft Daten von AgentDVR abgerufen werden | `30` |
+| HTTP-Timeout (ms) | Timeout pro API-Anfrage | `8000` |
+| Systemsteuerungs-Buttons | Arm/Disarm/Neustart/…-Buttons und Profil-Selektor anlegen | `true` |
+| PTZ-Steuerungs-Buttons | PTZ Hold-Switches pro Kamera anlegen | `true` |
+| Stream-URLs erzeugen | URL-States (Snapshot, MJPEG, MP4) pro Kamera anlegen | `true` |
+| Snapshot als Base64 | Aktuelles Kamerabild bei jedem Poll als Base64 speichern | `false` |
+| Ereignis-Datenpunkte | Aufnahme-Metadaten spiegeln (letztes Ereignis, Anzahl, …) | `true` |
+| Echtzeit-Push-Trigger | Push-Trigger-State anlegen, auf den Skripte subscriben können | `true` |
+| Übersichts-Widget | Einzelner HTML-State mit allen Kamera-Live-Kacheln | `true` |
+| Galerie-Widget pro Kamera | HTML-Aufnahmegalerie pro Kamera | `true` |
+| Roh-API-JSON speichern | Die vollständige getObjects-Antwort in `system.raw_getObjects` schreiben | `false` |
+
+## Datenpunkte
+
+Der Adapter erzeugt folgende Datenpunkt-Struktur. `<cam>` steht für `cam_<oid>_<name>`, z.B. `cam_8_Reolink`. Mikrofone verwenden dasselbe Layout mit Präfix `mic_<oid>_<name>`.
+
+### System
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `system.online` | boolean | R | Verbindung zu AgentDVR hergestellt |
+| `system.lastUpdate` | string | R | ISO-Zeitstempel der letzten erfolgreichen Abfrage |
+| `system.lastPoll` | number | R | Unix-Zeitstempel der letzten Abfrage |
+| `system.cameraCount` | number | R | Anzahl erkannter Kameras |
+| `system.disk_free_gb` | number | R | Freier Speicherplatz in GB |
+| `system.settings.*` | verschiedene | R | Flache AgentDVR-Servereinstellungen |
+| `system.stats.*` | verschiedene | R | CPU / RAM / Festplatten-Statistiken |
+| `system.status.*` | verschiedene | R | Systemstatus (armed, Geräteanzahl, Version, …) |
+| `system.raw_getObjects` | string | R | Roh-getObjects-JSON (wenn aktiviert) |
+
+### Systemsteuerung *(erfordert „Systemsteuerungs-Buttons")*
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `system.control.arm` | Button | W | System scharf schalten |
+| `system.control.disarm` | Button | W | System unscharf schalten |
+| `system.control.allOn` | Button | W | Alle Geräte einschalten |
+| `system.control.allOff` | Button | W | Alle Geräte ausschalten |
+| `system.control.reloadConfig` | Button | W | AgentDVR-Konfiguration neu laden |
+| `system.control.reloadObjects` | Button | W | Objekte neu laden |
+| `system.control.runStorageMgmt` | Button | W | Speicherverwaltung ausführen |
+| `system.control.blockExternal` | Button | W | Externen Zugriff sperren |
+| `system.control.unblockExternal` | Button | W | Externen Zugriff freigeben |
+| `system.control.restart` | Button | W | AgentDVR neu starten |
+| `system.control.refresh` | Button | W | Sofortige Abfrage erzwingen |
+| `system.profile.selector` | number | R/W | Aktiver Profil-Index — Dropdown aus AgentDVR befüllt (0 = Home, 1 = Away, …); aktives Profil wird bei jedem Poll aktualisiert |
+| `system.profile.list` | string | R | Verfügbare Profile als JSON-Array |
+
+### Pro Kamera / Mikrofon
+
+Die rohen Gerätedaten aus AgentDVR werden rekursiv gespiegelt (Tiefe konfigurierbar, Standard 6). Der wichtigste Unterordner ist `<cam>.data.*`:
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `<cam>.name` | string | R | Gerätename |
+| `<cam>.data.online` | boolean | R | Gerät ist online |
+| `<cam>.data.connected` | boolean | R | Stream ist verbunden |
+| `<cam>.data.recording` | boolean | R | Aufnahme läuft gerade |
+| `<cam>.data.detected` | boolean | R | Bewegung/Objekt erkannt |
+| `<cam>.data.detectorActive` | boolean | R | Bewegungsdetektor aktiv |
+| `<cam>.data.alertsActive` | boolean | R | Alarm aktiviert |
+| `<cam>.data.alerted` | boolean | R | Alarm wird gerade ausgelöst |
+| `<cam>.data.scheduleActive` | boolean | R | Zeitplan aktiv |
+| `<cam>.data.width` / `height` | number | R | Stream-Auflösung |
+| `<cam>.data.*` | verschiedene | R | Alle weiteren Geräteeigenschaften aus AgentDVR |
+| `<cam>.snapshot_b64` | string | R | Aktuelles Kamerabild als `data:image/jpeg;base64,…` (Rolle `media.picture`) |
+| `<cam>.control.record` | Button | W | Aufnahme starten |
+| `<cam>.control.recordStop` | Button | W | Aufnahme stoppen |
+| `<cam>.control.recordRestart` | Button | W | Aufnahme neu starten |
+| `<cam>.control.triggerRecord` | Button | W | Aufnahme auslösen (läuft bis Timeout) |
+| `<cam>.control.snapshot` | Button | W | AgentDVR einen Snapshot auf Disk speichern lassen |
+| `<cam>.control.refreshSnapshotB64` | Button | W | Aktuelles Bild abrufen und in `snapshot_b64` schreiben |
+| `<cam>.control.detect` | Button | W | Bewegungserkennung auslösen |
+| `<cam>.control.alertOn` | Button | W | Alarm aktivieren |
+| `<cam>.control.alertOff` | Button | W | Alarm deaktivieren |
+| `<cam>.control.switchOn` | Button | W | Gerät einschalten |
+| `<cam>.control.switchOff` | Button | W | Gerät ausschalten |
+| `<cam>.control.objectDetectOn` | Button | W | Objekterkennung aktivieren |
+| `<cam>.control.objectDetectOff` | Button | W | Objekterkennung deaktivieren |
+| `<cam>.control.recOnAlert` | Button | W | „Aufnahme bei Alarm" aktivieren |
+| `<cam>.control.recOnDetect` | Button | W | „Aufnahme bei Erkennung" aktivieren |
+| `<cam>.control.purge` | Button | W | Alle Aufnahmen im Geräteordner löschen |
+
+### PTZ *(nur Kameras, erfordert „PTZ-Steuerungs-Buttons")*
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `<cam>.control.ptz.left` | Switch | R/W | Nach links schwenken (halten = Dauerbewegung) |
+| `<cam>.control.ptz.right` | Switch | R/W | Nach rechts schwenken |
+| `<cam>.control.ptz.up` | Switch | R/W | Nach oben neigen |
+| `<cam>.control.ptz.down` | Switch | R/W | Nach unten neigen |
+| `<cam>.control.ptz.upLeft` | Switch | R/W | Diagonal oben-links |
+| `<cam>.control.ptz.upRight` | Switch | R/W | Diagonal oben-rechts |
+| `<cam>.control.ptz.downLeft` | Switch | R/W | Diagonal unten-links |
+| `<cam>.control.ptz.downRight` | Switch | R/W | Diagonal unten-rechts |
+| `<cam>.control.ptz.zoomIn` | Switch | R/W | Reinzoomen |
+| `<cam>.control.ptz.zoomOut` | Switch | R/W | Rauszoomen |
+| `<cam>.control.ptz.stop` | Button | W | PTZ-Bewegung stoppen |
+| `<cam>.control.ptz.center` | Button | W | In Mittelposition/Home fahren |
+
+### Stream-URLs *(nur Kameras, erfordert „Stream-URLs erzeugen")*
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `<cam>.urls.snapshot` | string | R | URL zum aktuellen JPEG-Snapshot (`/grab.jpg`) |
+| `<cam>.urls.photo` | string | R | URL zum Foto-Endpoint (`/photo.jpg`) |
+| `<cam>.urls.mjpeg` | string | R | URL zum MJPEG-Livestream (`/video.mjpg`) |
+| `<cam>.urls.mp4` | string | R | URL zum MP4-Livestream (`/video.mp4`) |
+
+### Ereignisse / Galerie *(nur Kameras)*
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `<cam>.events.*` | verschiedene | R | Metadaten der letzten Aufnahme (Dateiname, Datum, Dauer, Tags, …) — erfordert „Ereignis-Datenpunkte" |
+| `<cam>.push` | string | R | Push-Trigger — wird sofort aktualisiert wenn AgentDVR eine neue Aufnahme meldet — erfordert „Echtzeit-Push-Trigger" |
+| `<cam>.gallery` | string | R | HTML-Galerie der letzten Aufnahmen — erfordert „Galerie-Widget" |
+
+### Übersicht *(erfordert „Übersichts-Widget")*
+
+| Datenpunkt | Typ | R/W | Beschreibung |
+|-----------|-----|-----|-------------|
+| `overview` | string | R | HTML-Kachelraster aller Kameras mit Livestream-Links |
+
+## Snapshot als Base64
+
+Der State `snapshot_b64` enthält das aktuelle Kamerabild als `data:image/jpeg;base64,…`-String und kann direkt in vis/vis-2-Bild-Widgets verwendet werden, ohne dass der Browser einen eigenen HTTP-Request durchführen muss.
+
+**Manuell aktualisieren:** `true` in `<cam>.control.refreshSnapshotB64` schreiben — kein Adapter-Neustart nötig.
+
+**Automatisch aktualisieren:** „Snapshot als Base64" in den Adapter-Einstellungen aktivieren — dann wird der State bei jedem Poll-Zyklus neu befüllt.
+
+## Changelog
+
+<!--
+	Placeholder for the next version (at the beginning of the line):
+	### **WORK IN PROGRESS**
+-->
+### 0.0.4 (2026-06-27)
+* (ipod86) fix: DP-Rollen korrigiert: snapshot_b64 → state (E1008), Profil-Selektor → level (E1011)
+
+### 0.0.3 (2026-06-27)
+* (ipod86) feat: Profil-Selektor — liest Profile aus getObjects, beschreibbarer Dropdown mit aktivem Profil bei jedem Poll
+* (ipod86) feat: snapshot_b64-State (media.picture) immer vorhanden + manueller Refresh-Button; Auto-Poll optional
+
+### 0.0.2 (2026-06-27)
+* (ipod86) npm Trusted Publishing eingerichtet und Repochecker-Findings behoben
+
+### 0.0.1 (2026-06-27)
+* (ipod86) Erstveröffentlichung
+
+[Ältere Changelog-Einträge in CHANGELOG_OLD.md](CHANGELOG_OLD.md)
+
+## Lizenz
+MIT License
+
+Copyright (c) 2026 ipod86 <david@graef.email>
+
+Hiermit wird unentgeltlich jeder Person, die eine Kopie der Software und der zugehörigen Dokumentationen (die „Software") erhält, die Erlaubnis erteilt, sie uneingeschränkt zu nutzen, inklusive und ohne Ausnahme mit dem Recht, sie zu verwenden, zu kopieren, zu verändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, zu unterlizenzieren und/oder zu verkaufen, und Personen, denen diese Software überlassen wird, diese Rechte zu verschaffen, unter den folgenden Bedingungen:
+
+Der obige Urheberrechtsvermerk und dieser Erlaubnisvermerk sind in allen Kopien oder Teilkopien der Software beizulegen.
+
+DIE SOFTWARE WIRD OHNE JEDE AUSDRÜCKLICHE ODER IMPLIZIERTE GARANTIE BEREITGESTELLT, EINSCHLIEẞLICH DER GARANTIE ZUR BENUTZUNG FÜR DEN VORGESEHENEN ODER EINEM BESTIMMTEN ZWECK SOWIE JEGLICHER RECHTSVERLETZUNG, JEDOCH NICHT DARAUF BESCHRÄNKT. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHTINHABER FÜR JEGLICHEN SCHADEN ODER SONSTIGE ANSPRÜCHE HAFTBAR ZU MACHEN, OB INFOLGE DER ERFÜLLUNG EINES VERTRAGES, EINES DELIKTES ODER ANDERS IM ZUSAMMENHANG MIT DER SOFTWARE ODER SONSTIGER VERWENDUNG DER SOFTWARE ENTSTANDEN.

package/README.md

@@ -12,99 +12,175 @@
 
 ## agent-dvr adapter for ioBroker
 
-Connects ioBroker to AgentDVR: auto-discovers cameras, mirrors all device values as data points, delivers real-time triggers on new recordings, and generates a responsive HTML gallery with optional search and tag filtering.
-
-## Developer manual
-This section is intended for the developer. It can be deleted later.
-
-### DISCLAIMER
-
-Please make sure that you consider copyrights and trademarks when you use names or logos of a company and add a disclaimer to your README.
-You can check other adapters for examples or ask in the developer community. Using a name or logo of a company without permission may cause legal problems for you.
-
-### Getting started
-
-You are almost done, only a few steps left:
-1. Create a new repository on GitHub with the name `ioBroker.agent-dvr`
-1. Initialize the current folder as a new git repository:  
-	```bash
-	git init -b main
-	git add .
-	git commit -m "Initial commit"
-	```
-1. Link your local repository with the one on GitHub:  
-	```bash
-	git remote add origin https://github.com/ipod86/ioBroker.agent-dvr
-	```
-
-1. Push all files to the GitHub repo:  
-	```bash
-	git push origin main
-	```
-1. Add a new secret under https://github.com/ipod86/ioBroker.agent-dvr/settings/secrets. It must be named `AUTO_MERGE_TOKEN` and contain a personal access token with push access to the repository, e.g. yours. You can create a new token under https://github.com/settings/tokens.
-
-1. Head over to [src/main.ts](src/main.ts) and start programming!
-
-### Best Practices
-We've collected some [best practices](https://github.com/ioBroker/ioBroker.repositories#development-and-coding-best-practices) regarding ioBroker development and coding in general. If you're new to ioBroker or Node.js, you should
-check them out. If you're already experienced, you should also take a look at them - you might learn something new :)
-
-### State Roles
-When creating state objects, it is important to use the correct role for the state. The role defines how the state should be interpreted by visualizations and other adapters. For a list of available roles and their meanings, please refer to the [state roles documentation](https://www.iobroker.net/#en/documentation/dev/stateroles.md).
-
-**Important:** Do not invent your own custom role names. If you need a role that is not part of the official list, please contact the ioBroker developer community for guidance and discussion about adding new roles.
-
-### Scripts in `package.json`
-Several npm scripts are predefined for your convenience. You can run them using `npm run <scriptname>`
-| Script name | Description |
-|-------------|-------------|
-| `build` | Compile the TypeScript sources. |
-| `watch` | Compile the TypeScript sources and watch for changes. |
-| `test:ts` | Executes the tests you defined in `*.test.ts` files. |
-| `test:package` | Ensures your `package.json` and `io-package.json` are valid. |
-| `test:integration` | Tests the adapter startup with an actual instance of ioBroker. |
-| `test` | Performs a minimal test run on package files and your tests. |
-| `check` | Performs a type-check on your code (without compiling anything). |
-| `lint` | Runs `ESLint` to check your code for formatting errors and potential bugs. |
-| `translate` | Translates texts in your adapter to all required languages, see [`@iobroker/adapter-dev`](https://github.com/ioBroker/adapter-dev#manage-translations) for more details. |
-| `release` | Creates a new release, see [`@alcalzone/release-script`](https://github.com/AlCalzone/release-script#usage) for more details. |
-
-### Configuring the compilation
-The adapter template uses [esbuild](https://esbuild.github.io/) to compile TypeScript and/or React code. You can configure many compilation settings 
-either in `tsconfig.json` or by changing options for the build tasks. These options are described in detail in the
-[`@iobroker/adapter-dev` documentation](https://github.com/ioBroker/adapter-dev#compile-adapter-files).
-
-### Writing tests
-When done right, testing code is invaluable, because it gives you the 
-confidence to change your code while knowing exactly if and when 
-something breaks. A good read on the topic of test-driven development 
-is https://hackernoon.com/introduction-to-test-driven-development-tdd-61a13bc92d92. 
-Although writing tests before the code might seem strange at first, but it has very 
-clear upsides.
-
-The template provides you with basic tests for the adapter startup and package files.
-It is recommended that you add your own tests into the mix.
-
-### Publishing the adapter
-Using GitHub Actions, you can enable automatic releases on npm whenever you push a new git tag that matches the form 
-`v<major>.<minor>.<patch>`. We **strongly recommend** that you do. The necessary steps are described in `.github/workflows/test-and-release.yml`.
-
-Since you installed the release script, you can create a new
-release simply by calling:
-```bash
-npm run release
-```
-Additional command line options for the release script are explained in the
-[release-script documentation](https://github.com/AlCalzone/release-script#command-line).
-
-To get your adapter released in ioBroker, please refer to the documentation 
-of [ioBroker.repositories](https://github.com/ioBroker/ioBroker.repositories#requirements-for-adapter-to-get-added-to-the-latest-repository).
+Connects ioBroker to [AgentDVR](https://www.ispyconnect.com): auto-discovers all cameras and microphones, mirrors every device property as data points, provides buttons for all common commands (record, arm, PTZ, …), delivers push-triggered gallery updates on new recordings, and generates a responsive HTML gallery widget per camera.
+
+## Features
+
+- Auto-discovery of all AgentDVR cameras and microphones on startup
+- All device properties mirrored as data points (flattened from the API)
+- Per-device control buttons: record, snapshot, detect, arm/disarm alerts, switch on/off, object detection, purge, …
+- System-level buttons: arm, disarm, all on/off, reload, storage management, restart, …
+- **Profile selector** — writable dropdown that reflects the current AgentDVR profile (Home / Away / Night / custom); changes apply immediately
+- **Snapshot as Base64** — `snapshot_b64` state (role `media.picture`) per camera, writable via button or auto-updated every poll cycle
+- PTZ control with hold-to-move switches (left, right, up, down, diagonals, zoom in/out, stop, center)
+- Stream URLs per camera (snapshot, photo, MJPEG, MP4)
+- Push trigger state — ioBroker scripts can react instantly when AgentDVR reports a new recording
+- HTML gallery widget per camera (pure HTML/CSS or full JS mode with search and tag filter)
+- Overview widget combining all cameras in one HTML state
+- Raw API JSON state for advanced use cases
+
+## Configuration
+
+| Setting | Description | Default |
+|---------|-------------|---------|
+| AgentDVR IP | IP address of the AgentDVR server | — |
+| Port | AgentDVR port | `8090` |
+| Username / Password | Optional HTTP basic auth | — |
+| Poll interval (s) | How often to fetch data from AgentDVR | `30` |
+| HTTP timeout (ms) | Timeout per API request | `8000` |
+| System control buttons | Create arm/disarm/restart/… buttons and the profile selector | `true` |
+| PTZ control buttons | Create per-camera PTZ hold-switches | `true` |
+| Generate stream URLs | Create URL states (snapshot, MJPEG, MP4) per camera | `true` |
+| Snapshot as Base64 | Auto-fetch and store the current frame as Base64 on every poll | `false` |
+| Event data points | Mirror recording metadata (latest event, count, …) | `true` |
+| Real-time push trigger | Create push-trigger state that scripts can subscribe to | `true` |
+| Overview widget | Single HTML state combining all camera live tiles | `true` |
+| Gallery widget per camera | HTML recording gallery per camera | `true` |
+| Store raw API JSON | Write the full getObjects response to `system.raw_getObjects` | `false` |
+
+## Data points
+
+The adapter creates the following data point tree. `<cam>` stands for `cam_<oid>_<name>`, e.g. `cam_8_Reolink`. Microphones use the same layout but with prefix `mic_<oid>_<name>`.
+
+### System
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `system.online` | boolean | R | Connection to AgentDVR established |
+| `system.lastUpdate` | string | R | ISO timestamp of last successful poll |
+| `system.lastPoll` | number | R | Unix timestamp of last poll |
+| `system.cameraCount` | number | R | Number of cameras discovered |
+| `system.disk_free_gb` | number | R | Free disk space in GB |
+| `system.settings.*` | various | R | Flattened AgentDVR server settings |
+| `system.stats.*` | various | R | CPU / RAM / disk stats |
+| `system.status.*` | various | R | System status (armed, devices, version, …) |
+| `system.raw_getObjects` | string | R | Raw getObjects JSON (if enabled) |
+
+### System controls *(requires "System control buttons")*
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `system.control.arm` | button | W | Arm the system |
+| `system.control.disarm` | button | W | Disarm the system |
+| `system.control.allOn` | button | W | Switch all devices on |
+| `system.control.allOff` | button | W | Switch all devices off |
+| `system.control.reloadConfig` | button | W | Reload AgentDVR configuration |
+| `system.control.reloadObjects` | button | W | Reload objects |
+| `system.control.runStorageMgmt` | button | W | Run storage management |
+| `system.control.blockExternal` | button | W | Block external access |
+| `system.control.unblockExternal` | button | W | Unblock external access |
+| `system.control.restart` | button | W | Restart AgentDVR |
+| `system.control.refresh` | button | W | Force immediate poll |
+| `system.profile.selector` | number | R/W | Active profile index — dropdown populated from AgentDVR (0 = Home, 1 = Away, …) |
+| `system.profile.list` | string | R | Available profiles as JSON array |
+
+### Per camera / microphone
+
+The raw device data from AgentDVR is mirrored recursively (depth configurable, default 6). The most important sub-tree is `<cam>.data.*`:
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `<cam>.name` | string | R | Device name |
+| `<cam>.data.online` | boolean | R | Device is online |
+| `<cam>.data.connected` | boolean | R | Stream is connected |
+| `<cam>.data.recording` | boolean | R | Currently recording |
+| `<cam>.data.detected` | boolean | R | Motion/object detected |
+| `<cam>.data.detectorActive` | boolean | R | Motion detector enabled |
+| `<cam>.data.alertsActive` | boolean | R | Alerts enabled |
+| `<cam>.data.alerted` | boolean | R | Alert currently active |
+| `<cam>.data.scheduleActive` | boolean | R | Schedule enabled |
+| `<cam>.data.width` / `height` | number | R | Stream resolution |
+| `<cam>.data.*` | various | R | All further device properties from AgentDVR |
+| `<cam>.snapshot_b64` | string | R | Current frame as `data:image/jpeg;base64,…` (role `media.picture`) |
+| `<cam>.control.record` | button | W | Start recording |
+| `<cam>.control.recordStop` | button | W | Stop recording |
+| `<cam>.control.recordRestart` | button | W | Restart recording |
+| `<cam>.control.triggerRecord` | button | W | Trigger recording (runs until timeout) |
+| `<cam>.control.snapshot` | button | W | Tell AgentDVR to save a snapshot to disk |
+| `<cam>.control.refreshSnapshotB64` | button | W | Fetch current frame and write to `snapshot_b64` |
+| `<cam>.control.detect` | button | W | Trigger motion detection |
+| `<cam>.control.alertOn` | button | W | Arm alerts |
+| `<cam>.control.alertOff` | button | W | Disarm alerts |
+| `<cam>.control.switchOn` | button | W | Switch device on |
+| `<cam>.control.switchOff` | button | W | Switch device off |
+| `<cam>.control.objectDetectOn` | button | W | Enable object detection |
+| `<cam>.control.objectDetectOff` | button | W | Disable object detection |
+| `<cam>.control.recOnAlert` | button | W | Enable "record on alert" |
+| `<cam>.control.recOnDetect` | button | W | Enable "record on detect" |
+| `<cam>.control.purge` | button | W | Delete all recordings in the device folder |
+
+### PTZ *(cameras only, requires "PTZ control buttons")*
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `<cam>.control.ptz.left` | switch | R/W | Pan left (hold to keep moving) |
+| `<cam>.control.ptz.right` | switch | R/W | Pan right |
+| `<cam>.control.ptz.up` | switch | R/W | Tilt up |
+| `<cam>.control.ptz.down` | switch | R/W | Tilt down |
+| `<cam>.control.ptz.upLeft` | switch | R/W | Diagonal up-left |
+| `<cam>.control.ptz.upRight` | switch | R/W | Diagonal up-right |
+| `<cam>.control.ptz.downLeft` | switch | R/W | Diagonal down-left |
+| `<cam>.control.ptz.downRight` | switch | R/W | Diagonal down-right |
+| `<cam>.control.ptz.zoomIn` | switch | R/W | Zoom in |
+| `<cam>.control.ptz.zoomOut` | switch | R/W | Zoom out |
+| `<cam>.control.ptz.stop` | button | W | Stop PTZ movement |
+| `<cam>.control.ptz.center` | button | W | Move to center/home position |
+
+### Stream URLs *(cameras only, requires "Generate stream URLs")*
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `<cam>.urls.snapshot` | string | R | URL to current JPEG snapshot (`/grab.jpg`) |
+| `<cam>.urls.photo` | string | R | URL to photo endpoint (`/photo.jpg`) |
+| `<cam>.urls.mjpeg` | string | R | URL to MJPEG live stream (`/video.mjpg`) |
+| `<cam>.urls.mp4` | string | R | URL to MP4 live stream (`/video.mp4`) |
+
+### Events / Gallery *(cameras only)*
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `<cam>.events.*` | various | R | Latest recording metadata (filename, date, duration, tags, …) — requires "Event data points" |
+| `<cam>.push` | string | R | Push trigger — updated immediately when AgentDVR reports a new recording — requires "Real-time push trigger" |
+| `<cam>.gallery` | string | R | HTML gallery of recent recordings — requires "Gallery widget" |
+
+### Overview *(requires "Overview widget")*
+
+| Data point | Type | R/W | Description |
+|-----------|------|-----|-------------|
+| `overview` | string | R | HTML tile grid of all cameras with live stream links |
+
+## Snapshot as Base64
+
+The `snapshot_b64` state stores the current camera frame as a `data:image/jpeg;base64,…` string so it can be used directly in vis/vis-2 image widgets without a separate HTTP request from the browser.
+
+**Manual refresh:** Write `true` to `<cam>.control.refreshSnapshotB64` to fetch a new frame on demand — no adapter restart required.
+
+**Auto-refresh:** Enable *"Snapshot as Base64"* in the adapter configuration to refresh automatically on every poll cycle.
 
 ## Changelog
+
 <!--
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 0.0.4 (2026-06-27)
+* (ipod86) fix: snapshot_b64 role corrected to `state` (E1008)
+* (ipod86) fix: profile selector role corrected to `level` (E1011)
+
+### 0.0.3 (2026-06-27)
+* (ipod86) feat: profile selector — reads profiles from getObjects, writable dropdown with active profile reflected on every poll
+* (ipod86) feat: snapshot_b64 state (media.picture) always present per camera + manual refresh button; auto-poll optional
+
 ### 0.0.2 (2026-06-27)
 * (ipod86) setup npm trusted publishing and fix repochecker findings
 
@@ -134,4 +210,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/admin/i18n/de.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Max. Array-Länge zum Erweitern",
     "cfgEventTagsDynamic": "Ereignis-Tags automatisch aus Aufnahmen erkennen",
     "cfgEventTagsIgnore": "Zu ignorierende Ereignis-Tags (kommagetrennt)",
-    "cfgEventTags": "Feste Ereignis-Tags, die immer erstellt werden (kommagetrennt)"
-}
+    "cfgEventTags": "Feste Ereignis-Tags, die immer erstellt werden (kommagetrennt)",
+    "cfgEnableSnapshotB64": "Snapshot als Base64 (media.picture-State pro Kamera)"
+}

package/admin/i18n/en.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Max. array length to expand",
     "cfgEventTagsDynamic": "Auto-detect event tags from recordings",
     "cfgEventTagsIgnore": "Event tags to ignore (comma-separated)",
-    "cfgEventTags": "Fixed event tags to always create (comma-separated)"
-}
+    "cfgEventTags": "Fixed event tags to always create (comma-separated)",
+    "cfgEnableSnapshotB64": "Snapshot as Base64 (media.picture state per camera)"
+}

package/admin/i18n/es.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Longitud máxima de array a expandir",
     "cfgEventTagsDynamic": "Detectar automáticamente etiquetas de eventos desde grabaciones",
     "cfgEventTagsIgnore": "Etiquetas de eventos a ignorar (separadas por comas)",
-    "cfgEventTags": "Etiquetas de eventos fijas a crear siempre (separadas por comas)"
-}
+    "cfgEventTags": "Etiquetas de eventos fijas a crear siempre (separadas por comas)",
+    "cfgEnableSnapshotB64": "Snapshot como Base64 (estado media.picture por cámara)"
+}

package/admin/i18n/fr.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Longueur maximale du tableau à développer",
     "cfgEventTagsDynamic": "Détecter automatiquement les tags d'événements depuis les enregistrements",
     "cfgEventTagsIgnore": "Tags d'événements à ignorer (séparés par des virgules)",
-    "cfgEventTags": "Tags d'événements fixes à toujours créer (séparés par des virgules)"
-}
+    "cfgEventTags": "Tags d'événements fixes à toujours créer (séparés par des virgules)",
+    "cfgEnableSnapshotB64": "Snapshot en Base64 (état media.picture par caméra)"
+}

package/admin/i18n/it.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Lunghezza massima dell'array da espandere",
     "cfgEventTagsDynamic": "Rilevamento automatico dei tag degli eventi dalle registrazioni",
     "cfgEventTagsIgnore": "Tag degli eventi da ignorare (separati da virgola)",
-    "cfgEventTags": "Tag degli eventi fissi da creare sempre (separati da virgola)"
-}
+    "cfgEventTags": "Tag degli eventi fissi da creare sempre (separati da virgola)",
+    "cfgEnableSnapshotB64": "Snapshot come Base64 (stato media.picture per telecamera)"
+}

package/admin/i18n/nl.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Max. arraylengte om uit te breiden",
     "cfgEventTagsDynamic": "Gebeurtenistags automatisch detecteren uit opnames",
     "cfgEventTagsIgnore": "Te negeren gebeurtenistags (kommagescheiden)",
-    "cfgEventTags": "Vaste gebeurtenistags die altijd worden aangemaakt (kommagescheiden)"
-}
+    "cfgEventTags": "Vaste gebeurtenistags die altijd worden aangemaakt (kommagescheiden)",
+    "cfgEnableSnapshotB64": "Snapshot als Base64 (media.picture state per camera)"
+}

package/admin/i18n/pl.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Maks. długość tablicy do rozwinięcia",
     "cfgEventTagsDynamic": "Automatyczne wykrywanie tagów zdarzeń z nagrań",
     "cfgEventTagsIgnore": "Tagi zdarzeń do zignorowania (oddzielone przecinkami)",
-    "cfgEventTags": "Stałe tagi zdarzeń do zawsze tworzenia (oddzielone przecinkami)"
-}
+    "cfgEventTags": "Stałe tagi zdarzeń do zawsze tworzenia (oddzielone przecinkami)",
+    "cfgEnableSnapshotB64": "Snapshot jako Base64 (stan media.picture na kamerę)"
+}

package/admin/i18n/pt.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Comprimento máximo do array a expandir",
     "cfgEventTagsDynamic": "Detetar automaticamente tags de eventos das gravações",
     "cfgEventTagsIgnore": "Tags de eventos a ignorar (separadas por vírgulas)",
-    "cfgEventTags": "Tags de eventos fixas a criar sempre (separadas por vírgulas)"
-}
+    "cfgEventTags": "Tags de eventos fixas a criar sempre (separadas por vírgulas)",
+    "cfgEnableSnapshotB64": "Snapshot como Base64 (estado media.picture por câmera)"
+}

package/admin/i18n/ru.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Макс. длина массива для разворачивания",
     "cfgEventTagsDynamic": "Автоматически определять теги событий из записей",
     "cfgEventTagsIgnore": "Теги событий для игнорирования (через запятую)",
-    "cfgEventTags": "Фиксированные теги событий, которые всегда создаются (через запятую)"
-}
+    "cfgEventTags": "Фиксированные теги событий, которые всегда создаются (через запятую)",
+    "cfgEnableSnapshotB64": "Снимок в Base64 (состояние media.picture для каждой камеры)"
+}

package/admin/i18n/uk.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "Макс. довжина масиву для розгортання",
     "cfgEventTagsDynamic": "Автоматично визначати теги подій із записів",
     "cfgEventTagsIgnore": "Теги подій для ігнорування (через кому)",
-    "cfgEventTags": "Фіксовані теги подій, які завжди створюються (через кому)"
-}
+    "cfgEventTags": "Фіксовані теги подій, які завжди створюються (через кому)",
+    "cfgEnableSnapshotB64": "Знімок як Base64 (стан media.picture для кожної камери)"
+}

package/admin/i18n/zh-cn.json

@@ -36,5 +36,6 @@
     "cfgMaxArray": "要展开的最大数组长度",
     "cfgEventTagsDynamic": "从录像中自动检测事件标签",
     "cfgEventTagsIgnore": "要忽略的事件标签（逗号分隔）",
-    "cfgEventTags": "始终创建的固定事件标签（逗号分隔）"
-}
+    "cfgEventTags": "始终创建的固定事件标签（逗号分隔）",
+    "cfgEnableSnapshotB64": "快照为 Base64（每个摄像头的 media.picture 状态）"
+}

package/admin/jsonConfig.json

@@ -67,6 +67,11 @@
                     "label": "cfgEnableUrls",
                     "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
                 },
+                "enableSnapshotB64": {
+                    "type": "checkbox",
+                    "label": "cfgEnableSnapshotB64",
+                    "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
+                },
                 "enableEventDps": {
                     "type": "checkbox",
                     "label": "cfgEnableEventDps",