WebVTT to CutMarks Operation

ID: webvtt-to-cutmarks

Description

This operation parses a WebVTT Subtitle File and generates a JSON of CutMarks based on the Subtitle Timestamps. It's primary intention is to be used as a silence detection based on available subtitle information.

With the CutMarks to SMIL workflow operation this JSON can be converted to a SMIL that can be used in the Video Editor for cutting.

Parameter Table

Tracks are assumed to start at 0.

Configuration Keys Default value Example/Other Possible values Description
source-flavor None, must be set captions/vtt+en The Flavor of the WebVTT Subtitle File to parse, used for creating the CutMarks.
target-flavor None, must be set cut-marks/json The Flavor of the output JSON, which contains the CutMarks based on the subtitle information.
min-time-silence-in-ms 0 5000 Time (in ms) between two subtitles for them to be considered seperate cutting sections, otherwise they are merged. Basically the minimum length of a silent section for it to be cut out.
buffer-time-around-subtitle 0 1500 How much buffer time (in ms) to add before and after a subtitle/non-silent section.
track-flavor Optional/Empty presenter/source The flavor of the track related to the WebVTT, used for determining the end time of the video.
start-treatment IGNORE USE_FOR_MIN_TIME/ALWAYS_INCLUDE How to treat the beginning of the video in relation to the subtitle sections.
end-treatment IGNORE USE_FOR_MIN_TIME/ALWAYS_INCLUDE How to treat the end of the video in relation to the subtitle sections. (If not IGNORE, Needs track-flavor to be set)

Operation Example

<operation
    id="webvtt-to-cutmarks"
    description="Use WebVTT as a silence detection">
  <configurations>
    <configuration key="source-flavor">captions/vtt+en</configuration>
    <configuration key="target-flavor">cut-marks/json</configuration>
    <configuration key="min-time-silence-in-ms">5000</configuration>
    <configuration key="buffer-time-around-subtitle">1500</configuration>
    <configuration key="track-flavor">presenter/source</configuration>
    <configuration key="start-treatment">USE_FOR_MIN_TIME</configuration>
    <configuration key="end-treatment">USE_FOR_MIN_TIME</configuration>
  </configurations>
</operation>