Live Streams Management

Creating Streams

To create a new stream, click the "Add Stream" button and fill in the required fields:

Stream Name: A unique identifier for your stream (e.g., camera-lobby, live-event-1). Avoid spaces and special characters.
Source URL: The input URL for your stream source. Supports RTSP, HTTP/HTTPS, HLS, SRT, and RTMP protocols.
Protocol: Auto-detected from the URL, but can be manually overridden if needed.

# Example source URLs
rtsp://192.168.1.100:554/stream1
https://example.com/live/feed.m3u8
rtmp://source-server:1935/live/stream-key
srt://source-server:9000

Tip: Use descriptive stream names — they become part of the output HLS URL and make it easier to manage multiple streams.

Stream Control Buttons

Each stream in your panel has the following control buttons:

Start Begin stream processing

Stop Halt stream processing

Edit Modify stream settings

Delete Remove stream permanently

Preview Watch stream in browser

Logo/Watermark Add overlay branding

Restream Push to social platforms

Important: Deleting a stream is permanent and cannot be undone. Always stop a stream before deleting it.

Live Statistics Tracking

Each running stream provides real-time statistics including:

Input Bitrate: The bitrate of the incoming source stream
Output Bitrate: The bitrate of the processed HLS output
Frame Rate: Current frames per second (FPS)
Resolution: Input and output video dimensions
Uptime: How long the stream has been running continuously
Error Count: Number of decoding or encoding errors detected
Viewer Count: Active HLS connections (when available)

Tip: Monitor the error count — if it rises rapidly, your source may be unstable or the server may be under heavy load.

Bulk Operations

StreamDev supports bulk operations for managing multiple streams at once:

Select streams using the checkboxes next to each stream in the list
Select All with the master checkbox in the table header
Bulk Start: Start all selected streams simultaneously
Bulk Stop: Stop all selected streams at once
Bulk Delete: Remove multiple streams in a single action

Tip: Use bulk operations to quickly restart all streams after a server maintenance window or configuration change.

Advanced Input Options

For sources that require special handling, StreamDev supports custom HTTP headers and FFmpeg parameters:

Custom Headers

Some sources require specific HTTP headers for authentication or access control:

User-Agent: Override the default user agent string (e.g., VLC/3.0.18)
Referer: Set a custom referer header for sources that check origin
Origin: Specify the origin header for CORS-restricted sources

# Example custom header configuration
User-Agent: VLC/3.0.18 LibVLC/3.0.18
Referer: https://allowed-domain.com
Origin: https://allowed-domain.com

Extra FFmpeg Parameters

For advanced users, you can pass additional FFmpeg input parameters directly:

# Timeout and buffer settings
-timeout 5000000 -buffer_size 1024000

# Force TCP transport for RTSP
-rtsp_transport tcp

# Reconnect on failure (HTTP/HLS sources)
-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5

Important: Incorrect FFmpeg parameters can cause streams to fail. Only modify these settings if you understand their effects.

Watermark / Logo Overlay

Add your branding to any stream with the built-in watermark and logo overlay feature:

Supported Formats

PNG (recommended — supports transparency)
JPG/JPEG (solid backgrounds only)

Position Options

Choose from 5 predefined positions for your overlay:

Top Left

Top Center

Top Right

Center

Bottom Left

Bottom Right

Sizing & Opacity

Size: 5% to 50% of the video width
Opacity: Adjustable transparency control for subtle or prominent branding
Margins: 20px default padding from edges for clean positioning

Tip: Use a transparent PNG at 10–20% size for a professional, non-intrusive watermark. Position it in the bottom-right corner for broadcast-standard placement.

Stream Status Monitoring

StreamDev provides clear visual indicators for each stream's status:

Green (Active): Stream is running and producing output normally
Red (Stopped): Stream is not running
Yellow (Warning): Stream is running but experiencing issues (high error rate, low bitrate)
Blue (Starting): Stream is initializing and connecting to the source

Important: If a stream repeatedly cycles between Starting and Stopped, the source URL is likely unreachable or returning errors. Check the Troubleshooting guide for help.