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>