Video Library - Manage Video Text Tracks

 

Overview

A Video Text Track (VTT) is a file that contains text to be displayed by the video player. The video player supports four kinds of text tracks:

  • Captions - The transcription of the video in its "native" language. For example, a video in which English is the primary spoken language would have a Captions file with that text in English.
  • Subtitles - The transcription of the video in a language that's not its "native" language.
  • Descriptions - The textual descriptions of the video (e.g., "a tall bearded man in blue jeans and a cowboy hat comes in through the door").
  • Chapters - The major chapters/scenes to be used in a "table of contents" that a viewer can quickly jump to.

Note that Captions and Subtitles are similar, but there is a nuance between them: it is recommended that a video have at most one Captions file. Imagine a video where English is the primary spoken language, and it has timed transcripts available in English, Spanish, and French. The English transcript should be added as the single Captions file (because English is the video's "native" language) while the multiple non-English transcripts should be added as Subtitle files.

The video player automatically displays the Captions file (if there is one). The video player provides a menu listing all Caption options for the viewer to select their choice. Usually the only difference between caption files is the language used in each file, so when adding each track it is recommended to set its Label to the desired language text. (That is, just "English" not "English Captions" because the choices appear on a "captions" menu.) If there are English files for different regions, it would be appropriate to use Labels like English-US and English-UK.

If there's one or more Description files, the video player provides a menu for the viewer to select their choice. Usually the only difference between descriptions files is the language used in each file, so when adding each track it is recommended to set its Label to the desired language text. (That is, just "English" not "English Description" because the choices appear on a "description" menu.) If there are English files for different regions, it would be appropriate to use Labels like English-US and English-UK.

Currently the video player displays only the first Chapters file it finds. It is recommended to add only one Chapters file to ensure that the correct file is found.

Detailed Steps

There are many applications (online and offline) that can help you create VTT files more easily than doing it by hand. The typical output is a file that you could also create manually using Notepad--for example:

WEBVTT
Kind: captions
Source: Manually by Pat Smith
Source Version: 7/5/2021

00:00:00.192 --> 00:00:02.432
After completing this training program,

00:00:02.496 --> 00:00:03.968
you should know how to: 

00:00:04.448 --> 00:00:07.968
Properly handle food from the moment it enters your store

00:00:08.064 --> 00:00:10.496
till it leaves in when a customer purchases it;

00:00:11.008 --> 00:00:13.632
Minimize the risk of food contamination 

00:00:13.760 --> 00:00:17.472
foodborne illness as you move through your daily tasks;

00:00:18.144 --> 00:00:20.864
Maintain your personal hygiene on the job 

00:00:21.056 --> 00:00:23.072
so you don’t contaminate food; 

00:00:23.264 --> 00:00:28.224
and, clean and sanitize equipment and surfaces in your store 

00:00:28.352 --> 00:00:31.192
so food products avoid contamination.

Leave the first line as-is. Adjust the value on the second line to be accurate (captions, subtitles, descriptions, or chapters). Adjust the values on the third and four lines as appropriate. Leave the fifth line empty.

Below the fifth line, just include two lines for every item to display, followed by an empty line. The first line is the Start --> Stop times during which the text (on the next line) is applicable. The times are entered in HH:MM:SS.sss format. Note that there can be gaps between one item's Stop time and the next item's Start time.

Save the file using the extension .vtt so that it will show up when selecting a VTT file to upload.

  1. Click the + near the top-right of the Manage Video Text Tracks admin page.
  2. Select the Kind of VTT file you're adding,
  3. Select the Language of the text that's in the file,
  4. Enter the Label to be displayed to the viewer in the video player. Typically this should just be the language text that the viewer would understand (e.g., "English" not "English (EN)" or "English Captions").
  5. Select the VTT File to upload and and wait for the upload to reach 100%.
  6. Click Save to commit your changes, or Cancel to exit without adding a new VTT,

Note that no "rules" are enforced when adding/editing text tracks, which means it's possible to add four English Captions and select the same file evey time...but that would not result in an ideal experience for your viewer. The Overview section includes several recommendations.

After adding/editing video text tracks, an automated process will see that changes are happening on the specific video. It will continue monitoring the video until it sees no more changes have been made for about 15 minutes, and then it will forward all the changes to the video service provider to process. Within an hour the changes should start appearing as options everywhere that the video appears (including the Live environment without republishing anything).

  1. In the list of current Video Text Tracks, click Edit.
  2. Adjust Kind/Language/Label as needed.
  3. You do not need to upload a replacement VTT file, unless the content of that file has been changed. If it has been changed, select the VTT File to upload and and wait for the upload to reach 100%.
  4. Click Save to commit your changes, or Cancel to exit without saving any changes,

After adding/editing video text tracks, an automated process will see that changes are happening on the specific video. It will continue monitoring the video until it sees no more changes have been made for about 15 minutes, and then it will forward all the changes to the video service provider to process. Within an hour the changes should start appearing as options everywhere that the video appears (including the Live environment without republishing anything).

  1. In the list of current Video Text Tracks, click the Download icon. NOTE: You should always keep a local copy of all your original source files.
  1. In the list of current Video Text Tracks, click the Delete icon.
  2. Click Yes to confirm the deletion, or No to exit without changing anything.