Recordings

When you record your live broadcasts, the recorded files are automatically processed and saved for you. To manage your files go to the Recordings section of the Dolby.io dashboard.

📘

Recording is not available for free accounts. To access this feature, upgrade your account in the Dolby.io Dashboard.

The first thing that must be done to record a stream is to broadcast a live feed with your token set to Record.

If you have not created a token, or used the Online Broadcaster please read How to Broadcast in Dashboard before continuing.

Record with Broadcaster

An easy way to begin recording is enabling the Record feature directly from the dashboard's Online Broadcaster. Log into your Dolby.io Real-time Streaming account using the dashboard, create a token and initiate the live broadcaster interface by using the token's quick action menu.

From the Online Broadcaster's interface, click the Rec button located next to the broadcast Start button.

Once the record feature is active, the status icon will show OFF AIR / REC READY. Go ahead and press the Start button to begin broadcasting with recording enabled.

Allow the broadcast to record for at least 10 seconds then click the Stop button to stop the feed. Once you've stopped, go ahead and close the broadcaster interface. This will return you to the tokens page in the Live Broadcast page. From the left main menu, select the Recordings button to enter the recording page as shown above.

How to Record with Apps

You can record your broadcasts even if you are using 3rd party applications like OBS or your own custom broadcaster application.

If you have not broadcasted to Dolby.io Real-time Streaming from OBS, please read the Using OBS page before continuing.

At the moment this document was written, in order to use OBS with WebRTC you must use a modified version that has been extended to interface with our API. You can download it for MacOS or for Windows (version 10 or higher) HERE.

As before, we will start with a publishing token. Return to the Dolby.io dashboard and select the Live Broadcast from the left navigation menu.

Open the management view by clicking the settings button from the item’s quick action menu. This will open the Tokens details page. In the settings section make sure record is set to Recording On.

With this update to the token, any application broadcasting with this token will record automatically. To disable recording once again simply toggle the button back to Recording Off.

Note:
The recording property cannot be updated while the token is being used in a live broadcast, you must stop broadcasting to update it.

Setup OBS with the token information required and begin broadcasting for at least 10 seconds, then stop.

From the dash's left main menu, select the Recordings button to enter the recordings page again, as shown above to manage your recordings. See the next section to learn more about managing your recorded files.

Managing Recording

All of your recorded videos will listed in the Recordings section of the dashboard.

Search videos recorded from a specific token simply go into your token from the live broadcast section and click the settings button to open the management screen, then select the Recordings tab from the top of the panel.

You can click on the More Files button to see all the files recorded with the respective token. To learn more about the management screen click here.

Each thumbnail is displayed with a reference to your recording. A newly created recording can take a few seconds to several minutes to render. Once the recording has been processed you are able to view it.

You can download or delete the recording from the icons on the thumbnail directly, or you can click the thumbnail to preview the video.

To view your recorded videos, simply click on the thumbnail image which will open the Preview Player and begin playing the video. The player also provides more information about your recording including length, quality and dimensions. Click on the More Details button under the player to explore.

You can close the player using the close button located on the top right or you can scroll down to choose another video.

You can also delete or download your video using the icon menu under the preview player or directly from the thumbnail. Clicking the download icon (arrow icon here) will immediately initiate a download.

Note:
Recorded video downloaded will have audio codec as Opus. Playback on various media player may not support Opus and audio may not be herd. You can use VLC for playback and converting sound to AAC.

To delete a single video you can simply press the delete icon (trash icon here).

To delete multiple videos you can select the checkboxes on the thumbnails and then click the Delete Selected button from the section menu on the top right.

To delete all items at once click the Select All button from the same top section menu, this will select every thumb on the screen, then click the Delete Selected button to delete them all.

You can also change the list from a thumbnail grid to a basic list by clicking the List View button on the top right section menu.

You can see the current total storage used in the top right corner of the Recording page, or get your current billable storage in your Billing page.

To learn more about the recordings API and how to manage the calls yourself see the Recording API documentation.