Documentation

Live View

Live View is the multi-camera wall at /live, under NVR → Live View in the sidebar. It plays your cameras in a resizable grid and is where you add cameras through the Add Camera dialog. Viewing Live View requires the live.view permission; the + Add Camera tile and dialog only appear for users with cameras.manage.

Empty Live View grid with add-camera tiles

What you can do here

  • Arrange cameras in a grid using preset layouts (1×1, 2×2, 3×3, 4×4, plus 1+5, 1+7, 2+8, 1+12, 4+9, 1+1+10).
  • Drag a tile onto another to swap camera positions; the order is saved in your browser.
  • Add a camera to an empty tile via the Discover / Manual / Existing dialog.
  • Pan/tilt/zoom a supported camera with the floating PTZ pad.
  • Go Fullscreen for a video-wall view with a hover-reveal toolbar.

Live View with cameras streaming

Choose a layout

The default layout is 3×3. Change it from either the header or the bottom toolbar:

  1. Click a quick-layout button — 1×1, 2×2, 3×3, or 4×4.
  2. For the multi-size layouts, open the More (grid) dropdown and pick one — each entry lists how many cameras it holds (e.g. 1+5 · 6 cameras).
  3. Cameras fill tiles in order. To rearrange, drag a tile with a camera onto another tile to swap them.

[!TIP] The available layouts (and the default) come from Window Settings. Use ⚙ Configure Layouts… at the bottom of the layout dropdown to enable, disable, or add custom layouts.

Add a camera

Click the dashed + tile (“Click to add camera”) in an empty slot to open the Add Camera to Tile dialog. (The same dialog opens from the Cameras tab’s Add Camera button, titled Add New Camera.) It has up to three tabs: Discover, Manual, and Existing (the Existing tab appears only when cameras already exist).

Discover (ONVIF)

The Discover tab scans your network automatically the moment it opens.

  1. Wait for the scan — the header shows Scanning network… then Found N camera(s). Click Rescan to run it again.
  2. Click a discovered camera in the list to open the authentication step.
  3. Enter a Camera Name (required, e.g. Front Door, Lobby), then the Username (defaults to admin) and Password.
  4. Click Connect & Get Stream. OpenNVR authenticates over HTTP Digest and pulls the camera’s stream profiles.
  5. Pick a Stream Profile from the dropdown (each option shows its resolution, e.g. Profile1 (1920x1080)). The retrieved RTSP URL and a Device Information block (manufacturer, model, serial, firmware) appear.
  6. Click Add Camera.

[!NOTE] Docker bridge vs. host networking. ONVIF discovery uses a unicast scan of your subnet, so it works even in Docker bridge mode (the default on macOS/Windows) — you do not need host networking. If a scan turns up nothing, the camera may be on a different subnet or a VLAN that blocks the probe; use the Manual tab instead.

Manual

Use Manual entry when discovery can’t reach the camera or you already know its address.

Field Required Example Notes
Camera Name Front Door Label shown on the tile and in lists
IP Address 192.168.1.100 Camera’s IP
Port 554 RTSP port; defaults to 554
Username admin Camera login
Password Camera login
RTSP URL rtsp://192.168.1.100:554/stream1 Optional. Leave blank to build the URL from IP + credentials

The RTSP URL field has a Scan QR button that reads a stream URL from the OpenNVR Cam app. You don’t need to put credentials in the URL — the Username/Password above are added automatically. Click Add Camera to save.

Existing

The Existing tab lists cameras you’ve already added. Search by name and click one to drop it into the selected tile (no new camera is created).

Pan, tilt & zoom

On a tile with a live stream, click the floating PTZ button (bottom-left). A directional pad appears with arrows for pan/tilt, + / − for zoom, and a stop (■) button. Controls are press-and-hold; release to stop.

Fullscreen

Click Fullscreen in the bottom toolbar (or the header) to expand the grid. In fullscreen, move the pointer to the bottom edge to reveal the toolbar, which carries the same Menu, layout, and fullscreen controls.

📸 Screenshots to capture

This page reuses live view page empty .png and live view.jpeg. New shots to add under opennvr-site/public/screenshots/:

  • liveview-add-discover.png — the Add Camera dialog on the Discover tab after a scan, showing a discovered camera in the list and the Rescan button.
  • liveview-add-discover-auth.png — the Discover auth step: Camera Name, Username/Password, a selected Stream Profile, the Device Information block, and the green Stream URL Retrieved.
  • liveview-add-manual.png — the Manual tab filled in with a name, IP, port 554, and an RTSP URL.