Live Sources

A live source represents an incoming live video contribution feed. Live sources are supported as SRT-wrapped MPEG-2 transport streams that can contain H.264 or HEVC video and AAC or AC3 audio. A live source can be shared and used by multiple services simultaneously. For example, once a live source is established, it can be attached to a Lens sensor for real-time monitoring while simultaneously feeding into the Capture service to be recorded to disk. To view the Live Sources page, click Live Sources on the bottom left.

​

The Live Sources list

Each row is one live source. A redundant source carries a second connection. Double-click its row to expand it and reveal the Sec Address and Sec Connection Status columns for that connection.

​

Worker Status values

​

Connection Status values

​

What you can do in each status

A source must be deactivated before it can be edited or deleted, and deactivating is blocked while the source is still activating.

​

Filter Live Sources

To filter the list of live sources:

1. Click the Filter icon and do one of the following:
   • To display only live sources that use the Secure Reliable Transport (SRT) protocol: Expand the Type section and click SRT.
   • To filter the list by worker status: Expand the Worker Status section and select Active, Inactive, Error, Pending, or Stopping.
   • To filter the list by connection status, expand the Connection Status section and select one of the following: Connected, Disconnected, or Waiting.
2. Click Apply.

​

Search for a Live Source

To search for a live source, click the Search icon and type some or all of a source name. Only source names are matched.

​

Sort Live Sources

You can click the Source Name heading to sort the source list by source name. Click it again to reverse the order. Other columns cannot be sorted.

​

Copy a Primary Address

To copy a source’s primary address, click the Copy icon beside the primary address.

​

Add a Live Source

The Add Live Source panel has two steps: General Info and Stream Settings.

1. Click Add Live Source.
   
2. In the Name box, type a name for the source. Names are between 3 and 255 characters.
3. (Optional) In the Description box, type a description of the source.
4. From the Region list, select the region.
5. Click Next.
   
6. From the SRT Mode list, select Listener or Caller. The fields that follow depend on this choice.
   • Listener — UP assigns an address and waits for an encoder to connect to it.
   • Caller — UP connects out to an address you supply.
7. Complete the fields for the mode you chose.

   Field	Applies to	Description
   Primary IP Address	Caller	The address UP connects out to. Required.
   Primary Port	Caller	The port UP connects out to. Required.
   Whitelisted IP Addresses	Listener	Optional list of IPv4 addresses permitted to connect. Leave empty to accept any.

8. (Optional) To configure this as a redundant source, turn on the Redundant Source toggle. In Caller mode, also supply the Secondary IP Address and Secondary Port for the second connection.
9. In the Minimum Latency box, type or select the minimum latency in milliseconds, between 20 and 8000. The default is 20.
10. (Optional) To enable AES Encryption, turn on the AES Encryption toggle, then set:

    Field	Description
    AES Encryption Key Length	128 bits or 256 bits. Required.
    AES Encryption Passphrase	Between 10 and 79 characters. Required. Selectable only after a key length is chosen.
    Backup AES Encryption Key Length	Required when Redundant Source is also enabled.
    Backup AES Encryption Passphrase	Required when Redundant Source is also enabled.

11. (Optional) To enable SRT Passthrough, turn on the SRT Passthrough toggle, then set:

    Field	Description
    SRT Passthrough Mode	Listener or Caller. Required.
    IP Address / Port	Required in Caller mode — where the passthrough stream is sent.
    Whitelisted IP Addresses	Optional in Listener mode — IPv4 addresses permitted to connect.
    Latency (ms)	Required. Between 0 and 8000.

12. Click Save.

A new source is created Inactive. Activate it before sending a stream to it.

​

View Source Details

To view the details for a live source:

1. Click the Action icon (…) to the right of the source and select View Details.
2. On the Preview tab, UP displays a live preview of the source’s stream.
   
   On the audio bar graph, click S beside a channel number to listen to only that channel, or click M to mute it. All channels start muted. To view information about the audio track, expand the Audio Track section. The Text Tracks section lists the number of text tracks on the audio stream.
3. Click the Transport Statistics tab to view transport stream statistics. A redundant source shows primary and secondary statistics side by side.
4. Click the Passthrough Statistics tab to view statistics for the passthrough stream. This tab appears only when SRT Passthrough is enabled on the source.
5. Click the Metadata tab to view channel stream information.
6. Click the History tab to view the dates and times that the live source was connected and disconnected.

​

Modify a Live Source

A source can only be modified while it is Inactive. Deactivate it first.

1. Click the Action icon (…) to the right of the source and select Edit.
2. Modify the source as necessary and click Save.

Editing uses the same two steps as Add a Live Source. When you select a source row, the same commands are also available from the ribbon above the list.

​

Activate a Live Source

After you create a live source, it is inactive. To activate it, click the Action icon (…) to the right of the source and select Activate. The source moves to Pending while its ingest capacity is provisioned, then to Active, at which point its primary address is published and it can accept a connection.

​

Deactivate a Live Source

To deactivate a live source, click the Action icon (…) to the right of the source and select Deactivate. Deactivating releases the source’s ingest capacity and clears its addresses, connection state, and stream metadata. It is available while the source is Active or Pending.

​

Delete a Live Source

A source can only be deleted while it is Inactive. Deactivate it first.

1. Click the Action icon (…) to the right of the source and select Delete.
2. Click Delete to confirm that you want to delete the source. This action cannot be undone.

​

Copy a Source ID

To copy a source’s identifier — for a support request, or for an API call — click the Action icon (…) to the right of the source and select Copy ID.