Video Source

Use cameras, RTSP streams or files as input sources.

Overview

Outputs video frames at the configured frame rate & resolution, or at the source's native framerate / resolution if not configured.

Lumeo has broad support for video formats, including but not limited to :

  • container formats: asf, avi, 3gp/mp4/mov, flv, mpeg-ps/ts, mkv/webm, mxf, ogg and more.
  • codecs : h264, h265, mjpeg, vp8 and more.

Inputs & Outputs

  • Inputs : 1, Media Format : Any
  • Outputs : 1, Media Format: Same as Input
  • Output Metadata : Video source information

Properties

PropertyDescriptionTypeDefaultRequired
source_typeSource type. Options: Unset (null); Stream (stream); Camera (camera).enumnullNo
source_idSource idstringnullYes
framerateOutput frame rate. Range: minimum 1. Unit: fps.numbernullNo
resolutionOutput resolutionstringnullNo
cropCropstring0:0:0:0No
flipFlip. Options: Disabled (null); Horizontal (horizontal); Vertical (vertical).enumnullNo
rotateRotate (free angle). Unit: degrees.numbernullNo
rotate_fixed_angleRotate (fixed angle). Options: Disabled (null); 90° clockwise (clockwise90); 180° (clockwise180); 90° counter-clockwise (counter_clockwise90).enumnullNo
extra_metadataJSON dictionary inserted into metadata for every frame from this source.jsonnullNo
use_onvif_metadataExtract and insert ONVIF metadata from the input stream (when supported).boolfalseNo

Output Metadata

The fields and example below reflect this node's documented output structure.

PathTypeDescription
nodes.<node_id>.extra_metadata.keystringValue of key.
nodes.<node_id>.frame_numberintegerValue of frame number.
nodes.<node_id>.source_idstringValue of source id.
nodes.<node_id>.source_namestringValue of source name.
nodes.<node_id>.source_typestringValue of source type.
nodes.<node_id>.timestampstringValue of timestamp.
nodes.<node_id>.typestringIdentifies the node type that produced this metadata.
nodes.<node_id>.uristringValue of uri.

JSON example

{
  "nodes": {
    "video1": {
      "extra_metadata": {
        "key": "value"
      },
      "frame_number": 5,
      "source_id": "6372b7e6-e5d6-45b8-b31b-c400a3754ff4",
      "source_name": "Milestone-AXIS P1455-LE (172.16.0.38) - Camera 1",
      "source_type": "stream",
      "timestamp": "2025-11-11T16:43:57.536Z",
      "type": "video_source",
      "uri": "rtsp://172.16.0.45:554/live/658040e2-fe47-4d4b-9a27-2217af4c4193"
    }
  }
}

Did this page help you?