Ingest live video streams from network URLs

Use This When

• Building surveillance systems that process RTSP camera feeds in real-time
• Creating live streaming analytics for broadcast monitoring or content moderation
• Implementing edge video processing for IP cameras or cloud video services
• Developing dashboards that need continuous video ingestion from remote sources

What It Does

• Connects to network video streams (RTSP, RTMP, HTTP, HLS) and decodes frames continuously
• Supports FFmpeg backend (default) or GStreamer with automatic protocol-specific optimizations
• Handles connection failures with automatic retry logic and configurable timeout/delay
• Sanitizes URLs by removing whitespace and applies transport-specific option defaults

Works Best With

• RTSP cameras → this component → detect-objects → track-object for live surveillance
• HTTP/RTMP streams → this component → content analysis or quality monitoring
• Integration with output-browser-video for live monitoring dashboards
• Feeding detection pipelines that require continuous real-time video processing

Caveats

• Network latency and jitter affect frame timing; drop_frames=true prevents backpressure
• RTSP/RTMP authentication requires options parameter; configure credentials securely
• GStreamer backend requires OpenCV built with GStreamer support; falls back to FFmpeg if unavailable
• Timeout and retry settings critically affect resilience; tune based on network reliability