This article pertains to all LiveEdge Max 2, LiveEdge Max, EZ Max, and EZ Max 2 devices.
This guide walks you through how to install the required Docker container, create a GStreamer software input, and configure it for use on your Max device.
Table of Contents
Overview
Software Inputs on Max allow you to ingest an RTSP stream directly into the device using a software input (GStreamer). This is useful when you want to stream content without relying on physical (hardware) inputs.
Step 1: Install the RTSP Input Container
Pre-requisite: Your Videon Max device must contain the proper licensing to permit the installation of the RTSP Input container! If you need help gaining access to or trialing this license, reach out to Videon Support!
First, you need to install the RTSP Input container on your device.
Navigate to your device page in LiveEdge Cloud
Go to CONTAINERS
Select the STANDARD tab
Scroll down to find RTSP Input
Click the green INSTALL button
After a short time, the container will be downloaded and installed on your device.
Step 2: Create a GStreamer Software Input
Next, create a new input that will use the RTSP stream.
Go to CONFIGURATION → Inputs
Create a new GStreamer input
Name it Software Input (recommended for clarity)
This input will later be linked to the RTSP container.
Step 3: Find the Software Input ID
You will need the input channel ID to configure the container.
Go to your device's Device Info page on LiveEdge Cloud
Scroll to the Device State section
Locate the internal IP (only if local to the device. If you are remote from the device, these steps can be done via the LiveEdge Cloud API as well. Contact Videon Support for assistance.)
Open a new browser tab and enter:
http://<internal_ip>:2020/v2/in_channels
Find the entry for your GStreamer input
-
Note the following fields:
in_channel_id (this is your software input ID)
input_type: gstreamer (used for verification)
-
Example result
Step 4: Configure the RTSP Input Container
Now configure the container to send the RTSP stream into your software input.
Go to CONTAINERS
Find RTSP Input under installed containers
Click MANAGE
Select CONFIGURE CONTAINER
Fill in the following fields:
sw_input_id → enter the
in_channel_idfrom Step 3rtsp_url → enter your RTSP stream URL (must start with
rtsp://)enabled → check this option
Click Save.
Step 5: Verify the Software Input
Go to DEVICE INFO
Wait a few seconds. Under Configuration State, confirm that Software Input is updated
This indicates the container is successfully feeding the input.
Step 6: Attach the Software Input to an Encoder
Go to CONFIGURATION → Encoders
Select your desired encoder
Under Input Selection, choose Software Input
You can:
Use the same software input for both audio and video
Attach it to multiple encoders if needed
Tips & Notes
The RTSP stream must be active and accessible from the device
Ensure your RTSP URL is correctly formatted (
rtsp://...)To confirm you are using the software input, disconnect any hardware input cables
If the configuration does not update, wait a few moments and refresh
Once configured, your Max device will ingest and stream video using the RTSP-based software input.