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_typeType of video source : stream or camera

Note: Console provides a way to select from amongst IP Camera Streams, RTSP Streams and USB Cameras and populates source type and source id only when you deploy a Pipeline. This property is not available in the Pipeline node editor.

Source type Camera is only used for usb cameras.
stringTrue
source_idUUID of the source to use (Stream ID or Camera ID)

Note: Console provides a way to select from amongst IP Camera Streams, RTSP Streams and USB Cameras and populates source type and source id only when you deploy a Pipeline. This property is not available in the Pipeline node editor.
stringTrue
framerateOutputs video converted to this frame rate, irrespective of the source's native frame rate.

For USB Cameras, this node will select a frame rate from the set of frame rates that the camera supports, that is greater than or equal to the requested frame rate here.
integerNo
resolutionOutputs video converted to this resolution (widthxheight), irrespective of the source's native resolution. Ex 1920x1080

For USB Cameras, this node will select a resolution from the set of frame rates that the camera supports, that is greater than or equal to the requested resolution here.
stringNo
cropCrop video frame from each side by these many pixels. Format: left:right:top:bottom.string0:0:0:0No
flipFlip video in the specified direction. Options: null, horizontal, vertical.enumnullNo
rotateRotate the video by this angle, free form.integerNo
rotate_fixed_angleRotate the video by this angle. Options: null, 90, 180, 270enumnullNo
extra_metadataJSON key value pair dictionary to store arbitrary metadata to be passed to other nodes in the pipeline. Ex: {"key": "value"}JSONnullNo
use_onvif_metadataExtract and insert ONVIF metadata from the input stream such as detected objects.boolFalseNo

Metadata

Metadata PropertyExampleDescription
nodes.[node_id]video1Describes the Video source properties.
Format : as defined below.

[node_id] for Video Source Nodes is of the form videoX (ex. video1)
nodes.[node_id].typevideo_sourceNode Type : video_source
nodes.[node_id].source_typestreamType of video source.
stream, camera
nodes.[node_id].source_id93077c84-b9ce-409f-966f-bdf2bbc7c242Unique Source Identifier
nodes.[node_id].source_nameParking Lot test videoName of the video source as set in the Console
nodes.[node_id].urirtsp://128.0.1.1/live0Full URI for the video source.
Note: Credentials will be redacted from this URI for security purposes.
nodes.[node_id].extra_metadata{"key": "value"}Extra metadata inserted using extra_metadata node property
nodes.[node_id].frame_number5Frame number of this frame relative to start of video stream
nodes.[node_id].timestamp2025-11-11T16:43:57.536ZUTC Timestamp of this frame
"nodes":{
  "video1":{
    "type": "video_source", 
    "source_id": "6372b7e6-e5d6-45b8-b31b-c400a3754ff4", 
    "source_name": "Milestone-AXIS P1455-LE (172.16.0.38) - Camera 1", 
    "source_type": "stream",     
    "uri": "rtsp://172.16.0.45:554/live/658040e2-fe47-4d4b-9a27-2217af4c4193",
    "extra_metadata" : {
      "key": "value"
    },
    "frame_number": 5,
    "timestamp": "2025-11-11T16:43:57.536Z"
  }
}