medienbaecker/kirby-vtt

Makes subtitle uploads usable: converts SRT to WebVTT and strips broadcast timecode offsets

1.0.0 2026-08-06 12:07 UTC

Requires

• getkirby/cms: ^5.0
• getkirby/composer-installer: ^1.1 || ^1.2

MIT

• Thomas Günther

• webvtt
• subtitles
• kirby
• srt
• captions
• timecode

Published on Packagist.org on 2026-08-06 12:09 UTC

README

Subtitle exports browsers can't use: SubRip (.srt), which <track> doesn't accept, and broadcast timecodes starting at 10:00:00, which push every cue hours past the end of the video.

This plugin fixes both on upload.

Installation

composer require medienbaecker/kirby-vtt

Usage

Just upload the file in the Panel. untertitel.srt starting at 10:00:01,000 becomes untertitel.vtt starting at 00:00:01.000. Relative timings are kept, correct files are left alone.

There's also a CLI command:

vendor/bin/kirby vtt:fix

Options

'medienbaecker.vtt' => [
  'timecodeBase' => 36000
]

Seconds to strip, default ten hours. 0 only converts SRT.