ioBroker.agent-dvr

Tests:

agent-dvr adapter for ioBroker

Connects ioBroker to AgentDVR: 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).

This is a community-maintained integration, not affiliated with or supported by iSpyConnect. Please report issues via this repository's GitHub tracker, not iSpyConnect support channels.

Requirements

• ioBroker with iobroker.web adapter
• 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.

Features

• Auto-discovery of all AgentDVR cameras on startup (microphones excluded)
• 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, schedule on/off, detector on/off, sensitivity (min/max/gain), purge, …
• System-level buttons: arm, disarm, all on/off, reload, storage management, restart, …
• Profile selector — writable dropdown reflecting the current AgentDVR profile (Home / Away / Night / custom)
• Snapshot as Base64 — snapshot_b64 state per camera, writable via button or auto-updated every poll cycle
• PTZ control with hold-to-move switches
• Stream URLs per camera (snapshot, photo, MJPEG, MP4)
• Webhook endpoint for real-time updates — call it from an AgentDVR action to trigger an immediate full poll
• HTML recording gallery widget per camera (widget_recordings) and single-camera live tile (widget_live) — pure HTML/CSS or full JS mode with search and tag filter
• Overview widget combining all cameras in one HTML state
• Built-in live dashboard at http://<iobroker>:<webport>/agent-dvr.0/ — no additional app needed:
  • Per-camera stream selection: MJPEG, MP4/FLV with audio, or go2rtc WebRTC/MSE
  • 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
  • Real-time motion and alert indicators (yellow / orange tile border) via Socket.io
  • Fullscreen view with PTZ overlay, record, mute, and native browser fullscreen button; header auto-hides
  • Recordings tab with grid, timeline, and event log view, search, collapsible tag filter, and video player with prev/next navigation
  • Delete recording directly from the video player modal (requires AgentDVR v7.7.8.0+)
  • Recording display settings — ⚙ gear in the select/delete bar adjusts grid column width, max recordings shown and badge visibility (persisted in localStorage)
  • Camera colors are read from AgentDVR and applied to timeline bars and recording dots
  • PTZ presets — navigate to saved presets from the PTZ overlay (requires AgentDVR v7.7.8.0+)
  • Status bar shows camera count on the live view and recording/event count on the recordings view
  • Auto-reconnect for all stream types after network interruption or tab switch
  • Fully color-themeable via adapter config

Configuration

Tab: Connection

Setting	Description	Default
AgentDVR IP	IP address of the AgentDVR server	—
Port	AgentDVR HTTP port	8090
Username	Optional HTTP basic auth username	—
Password	Optional HTTP basic auth password	—
Poll interval (s)	How often to fetch data from AgentDVR (5–3600)	30
HTTP timeout (ms)	Timeout per API request (1000–30000)	8000

Tab: Features

Controls

Setting	Description	Default
System control buttons	Create arm/disarm/restart/… buttons and the profile selector	true
PTZ control buttons	Create per-camera PTZ hold-switches (left, right, up, down, diagonals, zoom, stop, center)	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

Events

Setting	Description	Default
Event data points	Mirror recording metadata (latest event, count, tags, …) per camera	true

Display

Setting	Description	Default
Overview widget	Single HTML state combining all camera live tiles	true

Proxy

Setting	Description	Default
Media proxy	Route MJPEG streams, snapshots, recording thumbnails and videos through ioBroker	false

Debug

Setting	Description	Default
Store raw API JSON	Write the full getObjects response to system.raw_getObjects	false

Tab: Dashboard

Default view

Setting	Description	Default
Default view	Which tab opens when the dashboard loads: Live or Recordings	Live
Show offline cameras	Display camera tiles even when the camera is offline	true
Max. recordings total	Maximum number of recordings shown across all cameras in the dashboard (newest first). Independent of the widget limit.	200

Camera grid

Setting	Description	Default
Columns	Number of grid columns (0 = auto-fit based on tile width)	0
Buttons always visible	Show record/PTZ buttons permanently instead of on hover only	false
Tag-badge position	Corner where the camera name badge appears on each tile	bottom-right

Stream

Setting	Description	Default
Refresh interval (s)	How often the dashboard re-fetches camera data (10–600)	60
Auto-reconnect streams	Automatically reconnect MJPEG, MP4/FLV and go2rtc streams after an error or tab switch	true

Color theme — 7 color pickers to match your UI:

Setting	Description
Background	Page/grid background color
Surface	Camera tile background
Accent	Highlight / active element color
Text	Primary text color
Border	Tile border color
Online indicator	Color of the online status dot
Offline indicator	Color of the offline status dot

Stream assignment

Here you assign a stream source to each camera individually. The dropdown shows all cameras discovered from AgentDVR (microphones are excluded).

Option	Description
MJPEG (AgentDVR)	Classic MJPEG stream served by AgentDVR — lowest latency, no audio
MP4 / FLV with audio (AgentDVR)	FLV stream proxied through ioBroker using flv.js — includes audio, correct aspect ratio
stream name (go2rtc)	WebRTC/MSE stream from go2rtc — smooth, low latency, audio support

The go2rtc stream names are fetched automatically from the go2rtc server when the admin UI is open. If the browser cannot reach go2rtc directly (e.g. mixed-content on HTTPS), the adapter fetches them on the server side as a fallback.

go2rtc URL (only visible when at least one camera uses a go2rtc stream)

Setting	Description	Example
go2rtc URL	Base URL of your go2rtc instance	http://192.168.1.10:1984

Note: go2rtc must already have the streams configured. The adapter only reads the stream list and proxies the WebSocket — it does not configure go2rtc.

Tab: Widget (gallery widget per camera)

General

Setting	Description	Default
Enable widget	Generate an HTML gallery widget per camera	true
Widget mode	No JS — pure HTML/CSS, embed anywhere; JS — full interactivity with search and tag filter	No JS

Layout

Setting	Description	Default
Max. entries	Maximum number of recordings shown in the widget	20
Min. column width (px)	Minimum width of each thumbnail column	150
Max. modal width (px)	Maximum width of the video playback modal	900

Tags

Setting	Description	Default
Show tags	Display recording tags on each thumbnail	true
Tag-badge position	Corner where tags appear on the thumbnail	bottom-left

Filter

Setting	Description	Default
Newest first	Sort recordings with the latest at the top	true
Show search	Show a text search field in JS mode	false
Compact mode	Denser layout with smaller thumbnails	false
Default tag	Pre-select this tag filter when the widget loads	—
Thumbnail size	Small / Medium / Large	Medium

Player

Setting	Description	Default
Live aspect ratio	Aspect ratio for the live stream preview, e.g. 16/9	—
Player URL	Custom URL for the video player used in the widget	—

Color theme — 5 color pickers + border radius:

Setting	Description
Card background	Widget card background
Tag background	Tag chip background
Tag text	Tag chip text color
Accent	Highlight color
Modal background	Video modal background
Border radius (px)	Rounded corner radius for cards

Tab: Advanced

Setting	Description	Default
Max. recursion depth	How many levels deep the API JSON is flattened into data points (1–10)	6
Max. array entries	Maximum number of array elements mirrored per property (1–500)	30
Dynamic tags	Automatically create a tag data point for every unique recording tag	false
Ignore tags (comma-separated)	Recording tags to exclude from event data points	—
Tag filter (comma-separated)	Only create event data points for recordings matching these tags	—

Live Dashboard

The adapter ships a built-in live dashboard at http://<iobroker>:<webport>/agent-dvr.0/. A second instance is reachable at /agent-dvr.1/, a third at /agent-dvr.2/, and so on.

Features:

• Per-camera stream selection: MJPEG, MP4/FLV with audio (via flv.js), or go2rtc WebRTC/MSE
• 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
• 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)
• Real-time motion (yellow border) and alert (orange border) indicators via Socket.io
• Auto-reconnect: MJPEG and FLV reconnect after error; go2rtc reconnects after unexpected WebSocket close or 10 s stall
• Recordings tab with grid, timeline, and event log view, search, collapsible tag filter, and video player with prev/next navigation
• Tag filter splits AgentDVR's comma-separated tags into individual chips for per-tag filtering
• Delete recording from the video player modal or select multiple with a long-press and bulk-delete (requires AgentDVR v7.7.8.0+)
• 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
• 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)
• Camera colors are read from AgentDVR and applied to timeline bars and recording dots
• PTZ presets — navigate to saved presets from the PTZ overlay; single selector data point per camera (requires AgentDVR v7.7.8.0+)
• Status bar shows camera count, CPU/RAM usage and disk free space
• Color theming via adapter config

go2rtc WebRTC Streams

go2rtc provides smooth, low-latency WebRTC/MSE streams with audio.

Setup:

1. Install and run go2rtc, configure your camera streams in go2rtc's config.
2. In the adapter config → Dashboard tab, assign the desired go2rtc stream name to each camera from the dropdown.
3. Enter the go2rtc URL that appears below the table (e.g. http://192.168.1.10:1984).
4. Save and restart. The adapter proxies WebSocket traffic through ioBroker to avoid browser cross-origin restrictions.

Media Proxy

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.

What is proxied	Proxy off	Proxy on
MJPEG live stream	direct AgentDVR URL	/agent-dvr.0/api/mjpeg?oid=…
Snapshot	direct AgentDVR URL	/agent-dvr.0/api/snap?oid=…
Recording thumbnails	direct AgentDVR URL	/agent-dvr.0/api/thumb?oid=…
Recording videos	direct AgentDVR URL	/agent-dvr.0/api/media?oid=…
FLV live stream	always via ioBroker	always via ioBroker
go2rtc WebSocket	always via ioBroker	always via ioBroker

FLV and go2rtc always run through ioBroker regardless of the setting — the browser cannot make cross-origin requests to these endpoints directly.

When to enable

• You access the dashboard from outside your home network where AgentDVR is not directly reachable from the browser
• Only ioBroker is exposed externally (e.g. via reverse proxy or VPN to ioBroker only)

When to leave it off

• Browser and AgentDVR are on the same network (local access)
• Direct connection is faster — no extra hop, lower latency
• Less load on the ioBroker server — streams do not pass through Node.js

Security

This adapter stores your AgentDVR admin credentials and exposes system.control.purge, system.control.restart and system.control.unblockExternal as one-click writable states — anyone who can reach the ioBroker web port can wipe recordings, restart AgentDVR or disable its external-access block. Make sure iobroker.web has authentication enabled before exposing ioBroker outside your LAN (directly or via a reverse proxy) — this is not the default in many ioBroker setups.

The setting takes effect immediately after saving — no restart required.

Data points

<cam> stands for cam_<oid>_<name>, e.g. cam_8_Reolink.

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 (0 = Home, 1 = Away, …)
system.profile.list	string	R	Available profiles as JSON array

Per camera

Data point	Type	R/W	Description
<cam>.name	string	R	Camera name
<cam>.data.online	boolean	R	Camera 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 camera on
<cam>.control.switchOff	button	W	Switch camera off
<cam>.control.objectDetectOn	button	W	Enable object detection (cameras only)
<cam>.control.objectDetectOff	button	W	Disable object detection (cameras only)
<cam>.control.scheduleOn	button	W	Enable the device schedule
<cam>.control.scheduleOff	button	W	Disable the device schedule
<cam>.control.detectorOn	button	W	Enable the motion detector
<cam>.control.detectorOff	button	W	Disable the motion detector
<cam>.control.sensitivityMin	number 0–100	R/W	Detector sensitivity — minimum threshold (cameras only)
<cam>.control.sensitivityMax	number 0–100	R/W	Detector sensitivity — maximum threshold (cameras only)
<cam>.control.sensitivityGain	number 0–100	R/W	Detector sensitivity — gain (cameras only)
<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 for this camera

PTZ (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
<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+)

Stream URLs (requires "Generate stream URLs")

Data point	Type	R/W	Description
<cam>.urls.snapshot	string	R	URL to current JPEG snapshot (cameras only)
<cam>.urls.photo	string	R	URL to photo endpoint (cameras only)
<cam>.urls.mjpeg	string	R	URL to MJPEG live stream (cameras only)
<cam>.urls.mp4	string	R	URL to MP4 live stream (cameras only)
<mic>.urls.audio_mp3	string	R	URL to MP3 audio stream (microphones only)
<mic>.urls.audio_ogg	string	R	URL to OGG audio stream (microphones only)

Events / Gallery (cameras only)

Data point	Type	R/W	Description
<cam>.events.*	various	R	Latest recording metadata — requires "Event data points"
<cam>.widget_recordings	string	R	HTML recording gallery — requires "Gallery widget"
<cam>.widget_live	string	R	HTML single-camera live tile — requires "Gallery widget"; snapshot refreshes on each adapter poll

Webhook

The adapter exposes a webhook endpoint that triggers an immediate full poll of AgentDVR:

GET http://<iobroker>:<webport>/agent-dvr.0/webhook

Replace agent-dvr.0 with the actual instance number (agent-dvr.1, etc.) if you run multiple instances.

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.

Returns {"ok":true} on success.

Overview (requires "Overview widget")

Data point	Type	R/W	Description
widget_live_overview	string	R	HTML tile grid of all cameras — snapshot refreshes on each adapter poll

Changelog

0.5.5 (2026-10-08)

• (ipod86) fix: live preview video no longer gets stretched/distorted — AgentDVR's live stream squishes the full picture into a fixed container format regardless of the camera's actual aspect ratio; now corrected (object-fit:fill) instead of shown distorted
• (ipod86) feat: configurable live-tile refresh interval (widgetLiveRefreshSec) — trade thumbnail freshness against keeping an open video modal open, since rewriting the widget's HTML state resets it
• (ipod86) feat: optional full-JS live-tile refresh mode (widgetLiveMode) — refreshes only the snapshot image via a small embedded script, so an open video modal never closes regardless of refresh frequency (requires script execution, same tradeoff as the existing gallery JS mode)
• (ipod86) feat: live widgets now share the gallery's theme colors, thumbnail size and compact setting, which previously only applied to the recordings widget
• (ipod86) refactor: reorganized the Widget settings panel into clearly scoped General / Recordings Widget / Live Widget / Theme sections with a proper two-level heading hierarchy, instead of one long section whose subsections looked like independent categories

0.5.4 (2026-10-08)

• (ipod86) fix: single-camera live widget snapshot never refreshed (missing cache-busting timestamp + signature-based dedup skipped rewriting the state)
• (ipod86) fix: live video element now receives the correct aspect ratio instead of the browser's default placeholder box before playback starts
• (ipod86) fix: live/recording video no longer gets stretched to fill a mismatched aspect-ratio box — degrades to letterboxing (object-fit:contain) instead

0.5.3 (2026-10-04)

• (ipod86) fix: clear ensuredFolders cache on object deletion to prevent stale "no existing object" warnings for rediscovered drives/cameras

0.5.2 (2026-08-05)

• (ipod86) feat: rename overview DP to widget_live_overview for consistent naming

0.5.1 (2026-08-05)

• (ipod86) feat: per-instance URL routing — each adapter instance uses its own URL namespace (agent-dvr.0/, agent-dvr.1/, …)
• (ipod86) feat: rename per-camera recording widget DP from widget to widget_recordings; add new widget_live DP with a single-camera live tile

Older changelog entries in CHANGELOG_OLD.md

License

MIT License

Copyright (c) 2026 ipod86 david@graef.email

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 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.