[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Mon Mar 14 2022

Contribution Encoder: OBS Studio Example

IntroductionLink Icon

OBS Studio is free, open source, easy to use encoder software to produce rich live content with lots of features. The software is popular among our customers for encoding live contribution streams.

OBS Studio is available on this page: Open Broadcaster Software

Note: At the time this tutorial was written, the OBS Studio version was 27.2.2. Other versions may differ slightly, but the principles are the same.

To use OBS Studio as a Contribution Encoder for Bitmovin, you will need to perform two steps:

  1. Set up the Live Encoding in Bitmovin Encoder
  2. Send the Contribution Stream from OBS Studio to Bitmovin Encoder.

Note: In this tutorial, we use OBS Studio to send an RTMP stream to Bitmovin Encoder. OBS Studio and Bitmovin Encoder also support the SRT protocol, which is out of scope of this tutorial.

Setting up the Live Encoding in Bitmovin EncoderLink Icon

  1. On your local machine, open a browser and log into your Bitmovin account.
  2. Set up a Live Encoding in Bitmovin Encoder. You have multiple options to do this:

    a. For a Quick Start, just open your Bitmovin Dashboard, go to ENCODING->Live Encodings and go through the wizard by clicking on the blue Create new live encoding button.Live Encoding Wizard Borders b. If you are already familiar with Bitmovin Encoder, you can also proceed according to this tutorial: Create a Live Encoding from an RTMP Stream

  3. Now we need the Stream URL (e.g. rtmp://a.b.c.d/live) and the Stream Key of the newly started Live Encoding. To get them, in the dashboard, go to ENCODING->Live Encodings and click on the newest encoding in the list. This opens the encoding’s page with the Live Encoding Ingest section, in which you see the Stream URL and the Stream Key to be used going forward. Live Encoding Intest Borders

Send a Contribution Stream from OBS Studio to Bitmovin EncoderLink Icon

  1. On your local machine, start OBS Studio. (If you start OBS Studio after a fresh install, it automatically opens the auto-configuration wizard. If this happens, just close the wizard).
  2. Open Preferences (or click on Settings on the bottom right). This opens the Settings Dialog.
  3. In the Settings Dialog, Click on Stream. This opens a dialog with three configuration options and one checkbox, see screenshot.

OBS Studio Settings Dialog Borders

  1. In this dialog, choose the following:

    a. As Service, choose Custom.
    b. As Server, type in or paste the Stream URL (e.g. rtmp://a.b.c.d/live) defined by the Bitmovin encoding.
    c. As Stream Key, choose the Stream Key that you got from your Live Encoding page.
    d. Leave the Use authentication checkbox unchecked (RTMP authentication is currently not supported by Bitmovin Encoder. If authentication is required for your production setup, we recommend using the SRT protocol).

  2. Click OK to close the dialog
  3. Now configure OBS to generate a Live Stream according to the manual, e.g. this Quickstart: Wiki - OBS Studio Quickstart | OBS . There are lots of tutorials and YouTube videos online that will be helpful learning OBS Studio.
  4. Click Start Streaming to begin sending the OBS stream to Bitmovin Encoder.
  5. If OBS shows a green light and the bitrate it sends (in its bottom right corner), then the stream is successfully sent to Bitmovin Encoder.

OBS Green Light

  1. Check in Bitmovin Encoder that the stream is succesfully received. Look at the Live Encoding Ingest section and verify that the Input Stream Status is Connected. Live Encoding Ingest Connected Borders

Note: If OBS Studio does not show a green light and the live stream is not received by Bitmovin Encoder, make sure the Stream URL is correct and you can reach the IP address from the computer running OBS Studio.

Give us feedback