Getting Started Cameras & Video Detection & Recording Automation & Events Actions Integration & Connectivity Network & Discovery AI & Remote Control MQTT Modbus ZeroMQ System & Administration Use Cases Troubleshooting About & Legal
Home / Documentation / Recording Playback
Knowledge base

Recording Playback

Recording Playback turns a media file from a configured file storage provider into a reusable video source. Use it to replay saved MP4, AVI, FLV, MOV, or MKV files through the same capture, detection, recording, and review workflow as a live stream.

Use stored media as a camera-like source

The component does not record by itself. It points Banalytics to an existing media file and exposes that file as a media stream source for downstream tasks. This is useful when you want deterministic testing, incident replay, demos, or processing of files that were produced outside the current live camera pipeline.

Replay incidents
Open an existing recording and run analysis on the same footage again without waiting for a live event.
Tune detectors
Use one stable file while adjusting motion, QR, sound, watermark, or classification settings.
Demo workflows
Show recordings, event snapshots, or automation behavior when no physical camera is available.
Process archives
Connect a file from local or mounted storage and feed it into the normal Banalytics task tree.

Adding a playback source

01

Prepare file storage

Create or select a file storage provider that can browse the folder containing the source video file.

02

Create Recording Playback

Add the Recording Playback component and give it a clear title, such as Incident replay or Detector test file.

03

Select the source file

Choose the file storage provider and pick a supported media file. The chooser accepts mp4, avi, flv, mov, and mkv files.

04

Add capture and analysis tasks

Add a media capture task under the playback source, then attach detection, snapshot, recording, watermark, or classification tasks as needed.

Configuration parameters

These are the parameters available when configuring Recording Playback.

ParameterRequiredDescriptionDefault
ID
YesUnique identifier generated automatically for this component instance. Read-only.Auto
Restart on failure
YesControls how the component is restarted after an error: stop on failure, immediately, 10 sec, 30 sec, or 1 min.10 sec
Title
OptionalDisplay name for this playback source. Use a title that explains why the file is used, such as Warehouse incident replay.None
File storage provider
YesFile system reference that owns the folder containing the media file.None
Path
YesSource media file URI inside the selected file storage provider. Supported extensions are mp4, avi, flv, mov, and mkv.None

When playback is the right source

01

Detector calibration

Use the same file while tuning motion thresholds, QR options, classifier classes, or sound thresholds. A fixed source makes it easier to compare settings.

02

Evidence review

Replay an important clip through Banalytics tasks to generate snapshots, watermarks, or additional events from already stored footage.

03

Regression tests for configuration

Keep a representative sample file and run it after configuration changes to confirm that detection zones, rotation, compression, and event rules still behave as expected.

04

Offline demonstrations

Use local video when a physical camera, ONVIF device, or network stream is not available during training, sales demos, or lab setup.

Tip: For files with audio, make sure the downstream capture and recording tasks are configured to keep audio only when it is actually needed. Disabling audio can reduce processing cost and avoid audio-related instability in video-only workflows.