Step-by-Step: Using the Live Module with Open Broadcaster Software (OBS)
The purpose of this Quick Start is to show you how to use the Video Cloud Live module and Open Broadcaster Software (OBS) to broadcast a live event.
To learn about all of the features and functionality available in the Live module, see Creating and Managing Live Events using the Live Module. For a series of best practices and recommendations to help ensure a high quality, stable live streaming experience, see Live Module Guidelines and Best Practices. For a list of all the options available from Brightcove for delivering live streaming video, see Delivering Live Streams.
Note: For a version of this document that uses the Telestream Wirecast encoder, see Step-by-Step: Using the Live Module with Telestream Wirecast.
Note: Live streaming support is available only for Video Cloud Pro and Enterprise publishers.
After completing this Quick Start, you should be able to:
- Use the Video Cloud Live module to create a live event
- Configure your encoder for a live event
- Trim your event and save it as a VOD asset in your Video Cloud account
This Quick Start will help you broadcast a live event to different devices using Open Broadcaster Software (OBS) Studio. OBS is open source software for video recording and live streaming and can be downloaded here. Other encoders can also be used with the Live module.
Any Video Cloud publisher who needs to broadcast a live streaming event using the Video Cloud Live module.
- Your encoder must output an RTMP stream
- Live broadcasts will experience a 20-30 second delay
- Streaming must begin within 30 minutes of the event start (default-level account setting)
- For users using Internet Explorer, version 10 or later is required
Steps to broadcast a live event
To stream your live event using the Live module, you will complete the following tasks:
Creating a new live event
- In a browser window, navigate to Video Cloud Studio.
- Enter your Video Cloud login credentials and click Sign In.
- The current Video Cloud account name will appear in the upper right corner of the page. If you have multiple accounts, click the account selector drop down and select the account you would like to save the live asset in. If you select an account that has not been enabled for Live, the Live module will open in trial mode.
- Click Live in the navigation header.
- Click the Create Event button to create a new event.
- Enter an Event Name.
- Enter some Tags for the event.
- If your account has been configured with required custom fields, make sure the custom fields are assigned values.
- Select a Live Ingest Profile from the dropdown list. The live ingest profile controls the number and quality of live renditions that are created.
- Select Convert event to video asset when complete. This will save the event as a video in the Media module.
- Click the ADVANCED OPTIONS link to expand the advanced options.
- Set the Reconnect Time to 1 minute.
- Select the Region closest to your location.
- Click Start Streaming. The Live module will return a Stream Endpoint (RTMP URL) and Stream Name. These values will be used in the encoder settings.
Configuring your encoder
In this section, we will configure and use the OBS Studio encoder to support a live streaming event. OBS Studio software is a desktop application that captures input from your camera and produces a stream that can be delivered by a CDN. Note that there are hardware and other software based encoding solutions available that may be better suited for delivering your live streaming event. You can download the OBS Studio software here.
Note: You should have the OBS software installed and a camera connected to your computer before proceeding
Note: This example uses a DSLR connected to a laptop using the Blackmagic Design UltraStudio Mini Recorder.
Note: OBS offers the ability to record a local copy of the stream. By choosing to do this, you will have a local copy of the stream that you can create clips from in case any networking issues occur during the broadcast of the event. For information on how to record a local file, see the OBS documentation.
- Open OBS Studio.
- In the Sources section, click + to add a new source. Select a Source from the list. This Quick Start is using a DSLR connected to a laptop using the Blackmagic Design UltraStudio Mini Recorder, so Blackmagic Device is selected.
- Enter a name for the new source and click OK.
- Select your camera from the Device list. A preview should appear in the properties dialog. Click OK.
- In the Controls section, click Settings.
- Click Stream in the left side of the Settings dialog.
- For the Stream Type select Custom Streaming Server.
- For the URL, use the Stream URL provided by the Live module.
- For the Stream key, use alive.
- Click OK to save the settings.
- In the Controls section, click Start Streaming. The live stream should begin.
Note: It will take about a minute to process your streams.
Publishing the live event
To generate the embed code for the live event, follow these steps:
- Return to the Live module.
- If the Control Room page for the event is not displayed, click the Live tab to display a list of live events. Click on the event name to open the Control Room page.
- Confirm that you can see the live stream. Note that after starting the encoder, it may take a minute for the live stream to appear.
- Click Publish and Embed.
- Select a Player and then click the Player URL to view the live stream.
- When you are done with the live stream, click the Stop Stream button in the Live module. Also, return to OBS Studio and click the stream button to stop the encoder from streaming.
Note: It is important to make sure you close/stop your encoder when the live stream is complete. Leaving a connection open between any encoder and Brightcove, even when no data is being sent, may result in unexpected connection charges.
Creating a clip
The Live module provides the ability to create video clips from completed events. Clips can also be created while a live event is in progress. There are several reasons you might want to create a clip:
- To create a short, teaser clip that can be posted to social media
- To limit the length of a video that you want to post (most platforms limit the length of videos)
- You have found that shorter videos perform better on social media
Clips can only be created within 24 hours of the event end. Afterwards, the Create Clip button will be disabled. If the event is longer than 24 hours, only the last 24 hours are clippable.
Note: For complete details on using the clipping interface, see Creating a Video Clip Using the Live Module.
To create a clip, follow these steps:
- Return to the Live module.
- Click the Completed tab.
- Locate the event and click the event name to open the Control Room.
- Click Create Clip. The clipping editor will open.
- Click and drag the clipping handles ()on the focus timeline to set the start and end points for the clip.
- Click Preview Clip to preview the clip. The start and end points can be adjusted as needed.
- Click Save Clip.
- Enter a Clip Name and other metadata values. Any required fields for the account will also appear and should be assigned values.
- Click Create Clip. The ingestion process will begin and the clip will be saved to your Video Cloud account.
- Clips will appear below the clip editor. Click Publish to Social to publish the clip to one of your social destinations using Brightcove Social. For information on publishing videos using the Social module, see Publishing Videos to Social Media Platforms.
- Click the Back to Control Room: Completed breadcrumb. All clips will also appear in the Control Room for the event.
Note: You can click the Create Clip button multiple times to create multiple clips of your broadcast. This allows you to trim and save as many times as you want for each broadcast, saving the clips as separate VOD assets in your media library.
Troubleshooting live stream issues
If you need further help getting your live event to work, you can contact us. To make sure you get the fastest response possible, below is a list of what support will need to solve the problem.
- The specific symptoms the stream is having. For example, does it not play at all or does it stutter or freeze?
- Whether this stream worked correctly in the past
- The entry point URL you are using in your encoder
- The stream name and Zencoder Job ID
- The encoding software and hardware are you using
- The URL to the player to which you have published the live event
- The video ID of your live asset in Video Cloud Studio
- The results of a trace-route from your encoder to the publishing point host