Getting Started Cameras & Video Detection & Recording Automation & Events Actions Integration & Connectivity Network & Discovery AI & Remote Control MQTT Modbus ZeroMQ System & Administration Comparisons Use Cases Troubleshooting About & Legal
Home / Documentation / Capture & Record Video with an ONVIF Camera
VID Task

Capture Video with
an ONVIF Camera

The Capture Video task enables live streaming, recording, and the advanced camera workflows in Banalytics. Unlike USB cameras, ONVIF cameras need this task added manually before the stream begins.

Adding the Capture Video task

01

Open your ONVIF camera

Navigate to your ONVIF camera in the Banalytics server view and open its configuration panel.

02

Add the Capture Video task

Click the Capture Video Task button in the task section for that camera.

03

Select a media profile and save

Choose a media profile from the dropdown. Banalytics retrieves these profiles directly from the camera after connecting to it.

04

Confirm the feed is live

Once saved, the video feed appears in the preview pane. You can start, stop, or delete the capture task from there.

Capture Video task configuration panel in Banalytics VMS
Before you begin: Media profiles must be pre-configured in the camera's own web interface before they appear as selectable options in Banalytics. If no profiles appear, log in to the camera web UI and create at least one media profile there first.

Recommended media profile presets

Creating multiple media profiles on your camera lets you switch between quality and bandwidth settings per task. The three presets below cover common ONVIF surveillance scenarios. RTSP is preferred over HTTP for real-time streaming.

MON
Remote monitoring
Resolution1920 x 1080
EncodingH.264H
ModeCBR
Frame rate15-20 FPS
Bitrate2048 kbps
MOV
Motion detection
Resolution1280 x 720
EncodingH.264B
ModeVBRNormal
Frame rate10 FPS
Bitrate1024 kbps
NET
Low bandwidth
Resolution640 x 480
EncodingMotionJPEG
ModeVBRPoor
Frame rate5 FPS
Bitrate512 kbps
Full media profile reference: For all encoding options, CBR vs VBR modes, and all six profile configurations, see the Media Profiles for ONVIF Cameras article.

Common issues and fixes

No video stream appears
Check the selected media profile and transport protocol. Ensure the profile exists on the camera's web interface. Try RTSP, which is the preferred protocol for real-time streams.
Choppy or stuttering video
Increase the RT Buffer value, or lower the resolution and frame rate in the camera's media profile. High-resolution streams need a larger buffer to avoid dropped frames.
No media profiles in the dropdown
Banalytics retrieves profiles directly from the camera. If the list is empty, create at least one media profile in the camera's own web interface, then reopen the task configuration.

Configuration parameters

ParameterRequiredDescriptionDefault
ID
YesA unique identifier automatically generated for this task instance. Read-only.Auto
Restart on failure
YesControls how the task behaves when an error occurs:
  • Stop on failure - not restarted until triggered manually
  • Immediately - restarts right after an error
  • 10 sec - restarts after a 10-second delay
  • 30 sec - restarts after a 30-second delay
  • 1 min - restarts after a 1-minute delay
10 sec
Device
YesSelect the ONVIF camera previously configured as an ONVIF Camera component.None
Media profile
YesSelect a media profile retrieved from the camera. Profiles must be created on the camera's own web interface first.None
Rotate image
OptionalRotates the video stream by 90, 180, or 270 degrees. Use this if the camera is mounted sideways or upside down.0
Disable audio
OptionalWhen enabled, the audio stream from the camera is not captured or processed. Recommended when audio is not required or to reduce bandwidth usage.Yes
RT Buffer (Mb)
YesAmount of memory in megabytes allocated for buffering real-time video frames. Increase this for high-resolution or high-FPS cameras to reduce dropped frames.40
Max fps (0 - disabled)
OptionalSets a cap on frames per second to reduce bandwidth usage. A value of 0 disables the cap and uses the FPS defined by the camera's media profile.0

What to do after capture is running

With the Capture Video task running, you can add further tasks to enable recording, motion detection, watermarking, and AI-based classification.

Related tasks and pages