Amazon Transcribe configuration

🚧Documentation Under Construction

We are actively working to improve this documentation. The content you see here may be incomplete, subject to change, or may not fully reflect the current state of the feature. We appreciate your understanding as we continue to enhance our docs.

With Amazon Transcribe, you can easily generate a transcript of an audio file or video file that you added to Brightspot. Editors can then perform a text search to find the file and use it in their own content.

Configuration

You can configure Amazon Transcribe at the Global level or the site level. Global configurations are inherited by all sites, and site-level configurations override Global configurations. This topic explains how to configure this integration at the Global level.

To perform this integration, you will need to have access to settings in your AWS console.

To integrate Amazon Transcribe with Brightspot:

1. Obtain the following from your AWS console:

   • SQS queue name for the transcription service. A list of available queues is in your Amazon SQS console.
   • Transcribe role ARN (as necessary; this role has access to the AWS Transcribe service). A list of available roles is in your Amazon IAM console.
   • AWS region (unless already configured on your Brightspot server).
   • Your AWS account's access key and secret access key (unless already configured for your other AWS services). A list of available accounts and associated access keys is in your Amazon IAM console.
2. Click > Admin > Sites & Settings > Sites > Global.

3. Under the Integrations tab, expand the AWS Transcribe cluster.

   

4. Toggle on Enable Transcribe Service.

5. Under Credentials, select one of the following:

   • Default—AWS credentials are configured on the Brightspot server.
   • Assume Role—Provide your AWS Role ARN from step 1 and an identifying session name for this service.
   • Static—Provide the access key and secret access key you determined in step 1.

6. In the Region field, enter the region to use when making requests to this AWS service.

7. In the SQS Queue Name field, enter your Amazon SQS queue name from step 1.

8. Under Transcribe Settings, click .

9. Select an existing transcription setting, or create a new setting by doing the following:

   Note

   The setting you select in this step is the default for all files submitted to AWS Transcribe. You can override these settings for individual submissions.

   1. In the content picker, under Create, click New Transcribe Settings.

      

   2. In the Name field, enter an internal name. Brightspot uses this name in selection fields.

   3. From the Language Code list, select one of the available languages, or select Default to use US English.

   4. To accommodate more than one voice in an audio file, toggle on Enable Multiple Speakers.

   5. If you want to share this setting with your other sites, do the following:

      1. Click to show the Sites widget.

      2. From the Owner list, select None.

      3. From the Access list, select All Others.

         

   6. Click Save.

   7. Click Back.

10. In the content picker, click the transcription setting you created.

11. Click Save.

Submitting a file to Amazon Transcribe

You can use the Amazon Transcribe service to generate transcripts of audio or video files you upload through Brightspot.

To submit a file to Amazon Transcribe:

1. To submit an audio file, do the following (otherwise skip to step 2):

   1. In Brightspot, create a new audio file from a file in .mp3, .wav, or .flac format. (For more information, see Audio File.)

   2. In the content edit form, from the Provider list, select AWS Transcribe.

   3. Under Items, click Add Audio File.

      

   4. Skip to step 3.

2. To submit a video file, do the following:

   1. In Brightspot, create a new video file from a file in .mp4 or .mov format. (For more information, see Video.)

   2. Under Items, click Add Video File, then select one of the following options:

      1. Select New Upload, and navigate to a file on your laptop.
      2. Select New URL, and paste the URL of a file.

3. If you want to use transcription settings different from the default, do the following:

   1. Toward the right of the widget, select > Advanced.

   2. Expand Transcribe, and select one of the transcription settings.

      

4. Complete the remaining fields in the content edit form.

5. Complete your site's workflow and publish the asset.

Brightspot sends the file to Amazon Transcribe for transcription, and receives the transcript a few minutes later. You can view the transcription in the asset's Transcription cluster.

For information about viewing a transcript, see Viewing and adding transcripts.

Viewing and adding transcripts

You can view a transcript of an audio or video file. You can also attach your own transcript to a file; this feature is useful if you want to annotate the original transcription.

To view and add a transcript:

1. Search for and open the asset in the content edit page.

2. Expand Transcription. A list of transcripts appears.

   

3. Click to view the entire transcript.

4. To add a transcript, do the following:

   1. Under Transcripts, click .

      

   2. In the Text field, type or paste the transcript.

   3. Click Publish.