File Output

Writes video with bounding box overlays to a file.

Single output

One file with all streams tiled together:

- type: "file"
  path: "/recordings/output.mp4"
  codec: "h264"
  container: "mp4"
  bitrate: 4000000
  encoder: "gpu"

Per-stream output

Separate file per input stream:

- type: "file"
  mode: "multi"
  codec: "h264"
  container: "mp4"
  bitrate: 4000000
  encoder: "gpu"
  streams:
    - source_id: 0
      path: "/recordings/cam0.mp4"
    - source_id: 1
      path: "/recordings/cam1.mp4"

Fields

Field	Type	Default	Description
path	string	—	Output file path (required when mode is single)
mode	string	"single"	"single" = one tiled file, "multi" = per-stream files
codec	string	"h264"	Video codec: h264 or h265
container	string	"mp4"	Container format: mp4 or mkv
bitrate	integer	4000000	Target bitrate in bits/sec (4 Mbps)
encoder	string	"gpu"	Encoder backend: gpu (NVIDIA hardware) or cpu (software)
streams	list	—	Per-stream output mappings (required when mode is multi)