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 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.

After completing this Quick Start, you should be able to:

  • Use the 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 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.

Audience

Any publisher who needs to broadcast a live streaming event using the Live module.

Prerequisites

  • An Enterprise account with access to the Live module
  • A camera to broadcast the event
  • You must have your own encoding software; this Quick Start uses OBS Studio which can be downloaded for free

Limitations

  • Your encoder must output an RTMP or SRT stream
  • Live broadcasts will experience a 20-30 second delay
  • Streaming must begin within 30 minutes of the event start (default-level account setting)

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

  1. Login to Studio.
  2. Open the Live module.
  3. Click the Create Event button to create a new event.
  4. Enter an Event Name.
  5. Enter some Tags for the event.
  6. If your account has been configured with required custom fields, make sure the custom fields are assigned values.
  7. Select a Live Ingest Profile from the dropdown list. The live ingest profile controls the number and quality of live renditions that are created.
  8. Select Convert event to video asset when complete. This will save the event as a video in the Media module.
  9. In the Stream Options section, select the Region closest to your location.
  10. In the Advanced Options section, set the Reconnect Time to 10 minutes.
  11. Click Create Event. 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.

  1. Open OBS Studio.
  2. In the Sources section, click + to add a new source. Select a Source from the list. This Quick Start is using a camera for video capture so Video Capture Device is selected.
  3. Enter a name for the new source and click OK.
  4. Select your camera from the Device list. A preview should appear in the properties dialog. Click OK.
  5. In the Controls section, click Settings.
  6. Click Stream in the left side of the Settings dialog.
  7. For the Stream Service select Custom....
  8. For the Server, use the Stream URL provided by the Live module.
  9. For the Stream Key, use alive.
  10. Click OK to save the settings.
  11. In the Controls section, click Start Streaming. The live stream should begin.

Publishing the live event

To generate the embed code for the live event, follow these steps:

  1. Return to the Live module.
  2. 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.
  3. 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.
  4. To publish the live event, click Publish and Embed in the left navigation.
  5. Select a player using the Available Player dropdown.
  6. Click the Player URL to view the live stream.
  7. When you are done with the live stream, click the Stop This Stream button on the Control Room page. Also, return to OBS Studio and click the Stop Streaming button to stop the encoder from streaming.

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 7 days 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.

To create a clip, follow these steps:

  1. Return to the Live module.
  2. Click the Completed tab.
  3. Locate the event and click the event name to open the Control Room.
  4. In the left navigation, click Create Clip. The clipping editor will open.
  5. Click and drag the clipping handles on the focus timeline to set the start and end points for the clip.
  6. Click Preview Clip to preview the clip. The start and end points can be adjusted as needed.
  7. Click Save.
  8. Enter a Clip Name and other metadata values. Any required fields for the account will also appear and should be assigned values.
  9. Click Create Clip. The ingestion process will begin and the clip will be saved to your account.
  10. 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.

Clips will also appear in the Control Room for the event.

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 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
  • The results of a trace-route from your encoder to the publishing point host