Update subtitles of an existing video

It is possible to update the subtitles of an existing video through the Magine Pro Console and through an API call. we allow the following actions:

• add additional subtitles

• remove a subtitle file

This feature is available in the Media & Metadata section of the Magine Pro Console for all assets transcoded after September 2021.

How to add/remove a subtitle file

1. Go to the Media & Metadata section of the Magine Pro Console.

2. Find the vod asset you want to update and head to the Linked Media tab.

3. Click "See more" beneath the linked media file. This will open up a new section which includes two tabs: Subtitles and Subtitle jobs.

4. In the Subtitles tab, you see all subtitles that are attached to the current media file and from here you can choose to Remove or Add new ones. You can only add one file at a time.

5. If you wish to add new subtitles, click Add, select the language and upload the srt file.

6. A bar shows you the progress. The subtitles should be added within minutes.

7. In the Subtitle jobs tab, you can see a history log of all changes done to the asset's subtitles.

Good to know

Before you add a new subtitle file please check that the format is supported.

You can only add one subtitle file per language, which means that if you want to add English when there already is an English subtitle available, the previous one will get overwritten.

Adding subtitles through API

It's also possible to do the above actions directly with an API call. You can find the documentation here.

A potential workflow can look like this:

1. To find information about already existing subtitle tracks, you do this API call and have the information in the property subtitleTracks https://tvoli.github.io/platform/#partner_transcode_asset__assetid__get

2. To add a new subtitle, you do this API call that will create a “subtitle job” that might take up to a few minutes until the subtitle is properly added: https://tvoli.github.io/platform/#partner_playables__assetid__subtitle_requests_post. If a subtitle already exists for that language, it will be replaced

3. You can also do a GET to this endpoint to see the status of all subtitle requests if you wonder what have happened to your previous request: https://tvoli.github.io/platform/#partner_playables__assetid__subtitle_requests_get. When a job SUCCEEDED the subtitle will be available right away for end users

4. To Delete a subtitle you do this request: https://tvoli.github.io/platform/#partner_playables__assetid__subtitle_requests__subtitlelang___subtitletype__delete