ProductsDocumentationBlogGitHubForums
Login >SIGN UP

Accessing and Managing Recordings

Suggest Edits

You can access and manage recordings either via the dashboard or REST APIs. To receive notifications about recordings that become available, you can use the Recording Webhook.

Accessing recordings from the dashboard

To find recordings for a specific token, open your Publish token from the Live Broadcast section and click the Settings button to open the management screen. Select the Recordings tab from the top of the panel. Each thumbnail is displayed with a reference to your recording. A newly created recording can take a few seconds to several minutes to render, depending on length. Once the recording has been processed, you can view it. You can click on the More Files button to see all the files recorded with the respective token.

Alternatively, to find all your recordings, open the Recordings section of the dashboard. You can view your recordings either as a thumbnail grid or a basic list by clicking the List View button on the top right section menu. Additionally, you can see the current total storage used in the top right corner of the Recording page, or get your current billable storage in the Billing page.

Previewing recordings

To preview your recordings, 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.

858

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

❗️

Audio codec of recordings

The downloaded recording will use the Opus audio codec. Playback on various media players may not support Opus and audio may not be heard. You can use VLC for playback and converting sound to AAC.

Downloading recordings

To download recordings, click the arrow icon visible on the thumbnail. You can also download your video using the icon menu under the preview player. Clicking the download icon immediately initiates a download.

Deleting recordings

The retention policy for recordings is determined by your business rules for removing and deleting the files.

Located next to the download button, the delete icon deletes the recording. 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.

1204

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.

1179

🚧

Deleting recordings is permanent

If you delete a recording it is immediate and permanent. We are unable to recover a recording once it has been deleted and removed from the cloud servers.

Accessing recordings using the REST API

👍

Using the REST APIs

Review the REST API platform guide for more details on generating an API secret for authentication. You need an API secret from the dashboard to make requests.

The Recording API provides a REST API for automating workflows for downloading and removing recordings. You can use the List Files REST API to query all the recordings for your account. Additionally, you can find recordings using the publish token or the stream name using the List Files By Token or List Files By Stream REST APIs, respectively.

Downloading recordings

You can use the Read File REST API to generate a URL link for downloading a recording. See the following example of an API request:

curl --request GET \
     --url https://api.millicast.com/api/record_files/699690 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer d47137c5c1fe0b52c43d9e00a7bafb11a60d4ad5b4e91fe06257e8c13aca01dd'

In the URL request (https://api.millicast.com/api/record_files/{recordFileId}), the recordFileld is the reference number allocated after a new recording is registered. As for the Bearer, it is the token associated not with a publish token but with your Dolby.io account. To find this information, visit the Settings section on the left panel in the dashboard. You can find the account's API secrets under Security. Tap on the Create button and label it as you wish. Copy the token and replace it with the code above. If the response is 200, then your JSON should look like this:

{
  "status": "success",
  "data": {
    "download": {
      "downloadUrl": "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/feed5e107691-825a-4a8e-936c-ce595529c4d0_full.webm?X-Amz-Expires=3600&response-content-disposition=attachment%3B%20filename%20%3D%20sxsw_1678731801.webm&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA4AHCQMSNIFIRHREE/20230720/us-west-1/s3/aws4_request&X-Amz-Date=20230720T201021Z&X-Amz-SignedHeaders=host&X-Amz-Signature=aa156f50a6c28fe907702ae6e8275f695ea8579b2da6a1c5d6503731c5b317bc",
      "downloadExpiresOn": "2023-07-20T21:10:21.6860061Z"
    },
    "id": 644690,
    "tokenId": 4369072,
    "token": "d4eff62e5e2761c1767c95e8ba460eca3cc354338539e41dbd9bb94c860e7ce",
    "streamName": "sxsw",
    "recordedOn": "2023-03-13T18:23:21Z",
    "status": "Complete",
    "metadata": {
      "format": "WEBM",
      "sizes": {
        "concat": 25701067,
        "dash": 25747521,
        "thumbnails": 463570
      },
      "duration": 85,
      "tracks": [
        {
          "type": "video",
          "codec": "VP8",
          "bitrate": 3577036,
          "width": 1280,
          "height": 720,
          "framerate": 0
        },
        {
          "type": "audio",
          "codec": "Opus",
          "bitrate": 24367,
          "channels": 2,
          "samplerate": 48000
        }
      ],
      "thumbnails": [
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-002.jpg",
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-003.jpg",
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-004.jpg",
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-005.jpg",
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-006.jpg",
        "https://milli-recording-storage-prd-02.s3.us-west-2.amazonaws.com/GCNQRh/5273f8407a72467196523e553c61442f/thumbs/feed5e107691-825a-4a8e-936c-ce595529c4d0-007.jpg"
      ]
    }
  }
}

The response not only contains the downloadURL but also the metadata of the fetched file, such as codec, bitrate, format, and frame rate. It also displays the information related to the Publish token under which it was recorded. To learn more about the recordings API and how to manage the calls, see the Recording API documentation.

Deleting recordings

You can use the Delete File REST API to delete one or more recordings associated with your account by specifying the record file ID. You can delete all recordings using the Delete All Files REST API.

🚧

Deleting recordings is permanent

If you delete a recording, it is immediate and permanent. We are unable to recover a recording once it has been deleted and removed from the cloud servers.

Updated 19 days ago