Skip to main content

Run without detectors

If you are only interested in recording 24/7 without running any sort of detection (motion, object, post processors) you can do so by using the following configuration:

This mode will use very little resources since the streams are never decoded.

ffmpeg: # Does NOT work with gstreamer as of now
camera:
camera_one:
name: Camera 1
host: !secret camera_one_host
path: /Streaming/Channels/101/
username: !secret camera_one_username
password: !secret camera_one_password
record_only: true
recorder:
continuous_recording: true # Not needed since it is the default, included for clarity
continuous: # Example of setting a max size of 10 GB for this individual camera
max_age:
days: 7

nvr:
camera_one:

tip

See the retention rules section for more information on retention rules.

Viewing the recordings

The created recordings can be viewed using the Timeline tab on the Events page

TODO: Add screenshot

Considerations

Enabling the record only mode comes with a few drawbacks.

Still image

The still image in the frontend camera cards is normally taken from the stream. When record_only: true is set, the stream is never decoded and the still image will not work.

If your camera supports taking snapshots via URL, you can utilize that in Viseron instead.

Here is an example for a Hikvision camera:

ffmpeg:
camera:
camera_one:
name: Camera 1
host: !secret camera_one_host
path: /Streaming/Channels/101/
username: !secret camera_one_username
password: !secret camera_one_password
record_only: true
recorder:
continuous_recording: true # Not needed since it is the default, included for clarity
continuous: # Example of setting a max size of 10 GB for this individual camera
max_age:
days: 7
still_image:
url: http://camera_one.lan:80/ISAPI/Streaming/channels/101/picture
username: !secret camera_one_username
password: !secret camera_one_password
authentication: digest

nvr:
camera_one:

Live stream

The live stream which is accessed from the button on the camera card will not work either. It is simply an MJPEG stream of what Viseron "sees", and since the stream is not decoded, Viseron never receives any frames. This will change in the future and true live streams will be added.

Until then, you can utilize the Events page to view the stream in (near) real time. It uses HLS so the delay is somewhere between 10-15 seconds.