Subtitle Timeshift Workflow Operation

ID: subtitle-timeshift

Description

The subtitle timeshift operation can be used to offset the timestamps of WebVTT subtitle files. One use case regards bumper/intro videos. For example: If a bumper/intro video gets added in front of an already subtitled presenter track, the subtitles would start too early. With this operation, you can select a video and a subtitle track and the timestamps of the captions file will be shifted backwards by the duration of the selected video. This ensures that the subtitles match the presenter track as intended.

Parameter Table

configuration keys required Example description
subtitle-source-flavor yes captions/source Flavor of the subtitle file(s) that shall be shifted.
video-source-flavor yes branding/bumper Flavor of the video that will be used to determine the duration for the shifting of the subtitle timestamps.
target-flavor yes captions/shifted Flavor of the subtitle file(s) that will be created including the shifted timestamps

Requirements

Please select a flavor for video-source-flavor that will select only a single/unique video. If multiple videos are selected, or (in other words) if it's not clear which video file the operation has to use, the operation will fail.

Additional Notes

The operation will simply skip if no subtitle file is found with the given subtitle-source-flavor.

On successful completion, the operation will create a new subtitle file in the process and will not override the old one. The tags of the original subtitle file will be copied to the new subtitle file.

Operation Examples

<operation
    id="subtitle-timeshift"
    description="Create new subtitle file with shifted timestamps">
  <configurations>
    <configuration key="subtitle-source-flavor">captions/source</configuration>
    <configuration key="target-flavor">captions/shifted</configuration>
    <configuration key="video-source-flavor">branding/bumper</configuration>
  </configurations>
</operation>