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
| Property | Description | Type | Default | Required |
|---|---|---|---|---|
source_type | Type of video source : stream or cameraNote: 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. | string | True | |
source_id | UUID 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. | string | True | |
framerate | Outputs 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. | integer | No | |
resolution | Outputs 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. | string | No | |
crop | Crop video frame from each side by these many pixels. Format: left:right:top:bottom. | string | 0:0:0:0 | No |
flip | Flip video in the specified direction. Options: null, horizontal, vertical. | enum | null | No |
rotate | Rotate the video by this angle, free form. | integer | No | |
rotate_fixed_angle | Rotate the video by this angle. Options: null, 90, 180, 270 | enum | null | No |
extra_metadata | JSON key value pair dictionary to store arbitrary metadata to be passed to other nodes in the pipeline. Ex: {"key": "value"} | JSON | null | No |
use_onvif_metadata | Extract and insert ONVIF metadata from the input stream such as detected objects. | bool | False | No |
Metadata
| Metadata Property | Example | Description |
|---|---|---|
nodes.[node_id] | video1 | Describes the Video source properties. Format : as defined below. [node_id] for Video Source Nodes is of the form videoX (ex. video1) |
nodes.[node_id].type | video_source | Node Type : video_source |
nodes.[node_id].source_type | stream | Type of video source.stream, camera |
nodes.[node_id].source_id | 93077c84-b9ce-409f-966f-bdf2bbc7c242 | Unique Source Identifier |
nodes.[node_id].source_name | Parking Lot test video | Name of the video source as set in the Console |
nodes.[node_id].uri | rtsp://128.0.1.1/live0 | Full 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_number | 5 | Frame number of this frame relative to start of video stream |
nodes.[node_id].timestamp | 2025-11-11T16:43:57.536Z | UTC 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"
}
}Updated about 2 hours ago
