Livestreams overview

Media Manager facilitates livestreaming video content.

Currently livestreaming is enabled on a team-by-team basis, contact us for more information.

Supported software encoders

Media Manager livestreams work with any encoder that supports RTMP streams. Some popular examples include:

• OBS (Free and Open Source)
• Wirecast (Commercial)
• XSplit (Commercial)
• vMix (Commercial)

Connection information

Media Manager supports both RMTP and SRT streams.

RMTP

In your encoder set:

• Stream Name Stream key provided on livestream page.
• Location (Hostname, or URL) rtmp://stream.mediamanager.io:5222/app

Tip

Some software may only have a single stream URL field, in which case enter rtmp://stream.mediamanager.io:5222/app/{stream key} replacing {stream key} with the key provided on livestream page.

SRT

The SRT stream protocol is a modern alternative to RTMP and is designed for high-quality, reliable point-to-point video transmission over unreliable networks.

To stream using SRT, in your encoder set:

• Stream Name Stream key provided on livestream page.
• Location (Hostname, or URL) srt://stream.mediamanager.io:6001
• Passphrase SRT Passphrase provided on the livestream page, you will be able to copy this after selecting SRT in the Stream Connection panel header.
• Mode Should be set to caller if required.
• Encryption Key Size / Length Set to 128 if expressed as bits, or 16 if expressed as pbkeylen.

Tip

Some software may only have a single stream URL field, in which case enter srt://stream.mediamanager.io:6001?streamid={stream key}&passphrase={srt passphrase} replacing {stream key} and {str passphrase} with the keys provided on livestream page. In OBS for example, the stream key can then be left empty.

Running a livestream

Tip

The livestream must be set to enabled - a disabled a livestream blocks streaming software from connecting

1. Go to the Livestreams page
2. Create a new livestream record
3. Copy the stream key from the details section and URL as described above into your broadcasting software
4. When you start streaming the livestream page should automatically detect this and update accordingly. A preview of your stream should appear after a few seconds
5. If you stop your stream through your streaming software/device the stream will remain active for 60 seconds before returning to idle automatically
6. Media Manager does not save any recordings from livestreams
7. The same livestream record in Media Manager can be re-used without the need to create a new record each time you go live

Webhooks

See the list of Livestream webhooks in Team Management section

API endpoints

• GET /api/v1/media - list all livestreams
• GET /api/v1/media/{token} - fetch details for a specific livestream
• POST /api/v1/media/livestream - create a livestream
• DELETE /api/v1/media/{token} - delete a livestream. Unlike Video and Audio, there is no 14 day period after deleting a livestream in which it can be restored.