Brightcove Integration

Rev’s Brightcove integration lets you order English captions and global subtitles by adding tags to your videos in Brightcove. About once an hour, Rev checks your linked Brightcove accounts, places an order for each newly tagged video, and delivers the finished captions or subtitles back to that video in Brightcove. You can link more than one Brightcove account, and linked accounts are available to everyone on your Rev account.

In this article

Connect Brightcove and Rev Accounts

Connecting takes a few minutes. You’ll need your Brightcove admin access so you can create API credentials. To link more than one Brightcove account, repeat these steps for each account.

 

Ensure your Rev account has a payment source

You need a payment source on your Rev account before the integration can place orders. You can add one in either of these ways:

If a payment fails, Rev pauses automatic orders for your Brightcove account until the payment is resolved.

 

Add a New Linked Account on Rev.com

  1. On your Rev Account Settings page, scroll down to Integration Settings and click Link New Account. 

    Integration Settings section of Rev Account Settings with the Link New Account button

  2. Under Type, select Brightcove.

    Link New Account window with Brightcove selected in the Type menu
  3. Keep this window open. You’ll paste your Brightcove credentials into it in the next steps.

 

Register Brightcove application

  1. Log in to Brightcove and open the Admin menu in the top-right corner, then select API Authentication. 

    Brightcove Admin menu with API Authentication highlighted

  2. Click Register New Application. 

    Brightcove API Authentication page with the Register New Application button

  3. Name the application and select at least one Brightcove account to authorize.

    Brightcove Register New Application form with a name field and an account selected for authorization

  4. Under Exposed Brightcove APIs, select these permissions, then click Save: under CMS, select Video Read and Video Read/Write; under Ingestion Profiles, select Configuration Read, Configuration Read/Write and Read. 

    Brightcove Exposed APIs list with CMS Video Read, Video Read/Write and Ingestion Profiles Configuration Read, Configuration Read/Write and Read selected
  5. Copy the Client ID and Client Secret. Brightcove shows the client secret only once, so copy it before you close the window.
Brightcove Copy Your Client Secret window showing the Client ID and Client Secret

 

Input Brightcove credentials

  1. In Rev’s Link New Account window, paste the Client ID and Client Secret. 

    Rev Link New Account window with the Client ID and Client Secret fields highlighted

  2. In Brightcove, open the Admin menu and select Account Information. 

    Brightcove Admin menu with Account Information highlighted

  3. Copy the Account ID.

    Brightcove Account Information page with the Account ID highlighted

  4. Paste the Account ID into Rev’s Link New Account window.

    Rev Link New Account window with the Account ID field highlighted and the Link button
  5. Click Link. Your Brightcove account is now connected, and Rev will start checking it for tagged videos.

Next, tag your videos to place orders.

Back to top

Place Orders With Tags

To order captions or subtitles, add Rev tags to your videos in Brightcove. Rev orders English captions for videos tagged rev-en, and a subtitle order for each language tag.

 

Select your videos

In Brightcove, go to your videos list, select the videos you want to send to Rev, and click Quick Edit.

Brightcove videos list with two videos selected and the Quick Edit button highlighted

 

Tag videos with “Rev”

In Tags To Add, enter the tags for the captions or subtitles you want, then click Save. See Brightcove Tags for the full list. A subtitle order automatically includes an English caption order, so you don’t need to add rev-en when you add a subtitle tag.

Brightcove Quick Edit panel with a Rev tag entered in Tags To Add

 

For Rush turnaround, add the rev-rush tag at the same time as your other Rev tags. Rush applies to English captions only, not subtitles. Rev removes the rev-rush tag after the order is delivered.

Rev checks your linked Brightcove accounts for newly tagged videos about once an hour. When Rev places the order, it updates the tags: rev-en changes to rev-placed, and a subtitle tag such as rev-fr changes to rev-fr-placed. A subtitle tag also adds rev-placed for the English captions included with it.

Rev places only one order per video and language. To order again, add the rev-redo tag along with the language tag. Use rev-redo when:

  • An order was canceled and you don’t think poor audio or very difficult content was the reason. (Canceled orders don’t change the video’s tags.)
  • The video already has a caption track, including one Brightcove generated automatically, or one from an earlier Rev order.

Rev removes the rev-redo tag after it places the new order. If the original order was canceled for poor audio or very difficult content, we don’t recommend reordering, because the same issues will affect the new captions.

 

Receive your captions and subtitles

When an order is complete, Rev adds the captions or subtitles to the video in Brightcove as a text track and changes the tag to -completed. For example, rev-placed becomes rev-completed, and rev-es-la-placed becomes rev-es-la-completed. You can also view and edit the files in your Rev account.

Back to top

Brightcove Tags

  • rev-en: English captions
  • rev-ar: Arabic subtitles
  • rev-zh-si: Chinese (Simplified) subtitles
  • rev-zh-tr: Chinese (Traditional) subtitles
  • rev-cs: Czech subtitles
  • rev-nl: Dutch subtitles
  • rev-fr: French subtitles
  • rev-de: German subtitles
  • rev-hi: Hindi subtitles
  • rev-it: Italian subtitles
  • rev-ja: Japanese subtitles
  • rev-ko: Korean subtitles
  • rev-pl: Polish subtitles
  • rev-pt-br: Portuguese (Brazil) subtitles
  • rev-ru: Russian subtitles
  • rev-es-es: Spanish (Spain) subtitles
  • rev-es-la: Spanish (Latin America) subtitles
  • rev-tr: Turkish subtitles
  • rev-rush: Rush turnaround for English captions
  • rev-redo: Places a new order for a video Rev has already processed

Back to top

Troubleshooting Brightcove Orders

If a tagged video doesn’t show up in Rev after an hour or two, check these common causes:

  • Misspelled or missing tag: Rev only recognizes the tags listed in Brightcove Tags.
  • No MP4 rendition: Rev can only pull videos that have an MP4 rendition. Use the Multiplatform Extended with MP4 ingest profile, and retranscode any existing videos with it. Setting it as your default ingest profile covers future uploads.
  • Video hosted elsewhere: Rev can’t pull a video whose source is a remote URL. The video must be hosted in Brightcove.
  • Already ordered or already captioned: If Rev has already processed the video in that language, or the video already has a caption track, add rev-redo.
  • Payment issue: If a payment fails, Rev pauses automatic orders until the payment is resolved.
  • Video replaced after tagging: Rev delivers captions to the original Brightcove video ID. If you replace the video after tagging it, the captions can’t be delivered. Tag the new video instead.
  • Captions didn’t appear in Brightcove: Text tracks need a Dynamic Delivery ingest profile, such as Multiplatform Extended with MP4.

If you still need help, email support@rev.com.

Back to top

Related to