glut23/webvtt-py：用Python读取、写入、转换和分割WebVTT字幕文件

项目介绍

glut23/webvtt-py 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 MIT License 许可证，目前获得 235 个 Star、66 次 Fork。

仓库全名: glut23/webvtt-py

README 摘要

webvtt-py ========= pypi| |pyversions| |license| |coverage| |build-status| |docs-status| |downloads| webvtt-py is a Python library for reading, writing and converting WebVTT caption files. It also features caption segmentation useful when captioning HLS videos. Documentation is available at https://webvtt-py.readthedocs.io. .. WebVTT: https://www.w3.org/TR/webvtt1/ .. HLS videos…

完整内容见 GitHub 原始 README 或本页。

常见问题

webvtt-py 用什么语言开发？

主要使用 Python 编写，采用 MIT License 许可证，目前有 235 个 Star。

webvtt-py 可以免费商用吗？

如何获取 webvtt-py 的源码？

可以直接克隆仓库：git clone https://github.com/glut23/webvtt-py.git，默认分支为 master；安装与运行步骤见仓库 README。

webvtt-py 最近还在维护吗？

仓库最近一次更新为 1 周前，当前有 23 个未关闭 Issue；Star 数为 235，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

Read, write, convert and segment WebVTT caption files in Python.

captions hls python sbv srt subtitles subtitles-parsing webvtt

MIT License
235 Stars
66 Forks
2 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

369

价值分

159

活跃状态

活跃

GitHub

语言占比

Makefile

Python

SRecode Template

Release

0.8.0 (08-11-2026)6 天前
0.7.0 (01-11-2026)1 周前
0.6.0 (25-10-2026)2 周前
0.5.1 (30-05-2024)2024年5月30日
0.5.0 (15-05-2024)2024年5月16日

贡献者

webvtt-py

webvtt-py is a Python library for reading, writing and converting WebVTT_ caption files. It also features caption segmentation useful when captioning HLS videos_.

Documentation is available at https://webvtt-py.readthedocs.io.

… _WebVTT: https://www.w3.org/TR/webvtt1/ … _HLS videos: https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis

Installation

$ pip install webvtt-py

Usage

… code-block:: python

import webvtt

for caption in webvtt.read(‘captions.vtt’): print(caption.identifier) # cue identifier if any print(caption.start) # cue start time print(caption.end) # cue end time print(caption.text) # cue payload print(caption.voice) # cue voice span if any print(caption.voices) # voices of every voice span in the text

Writing captions

… code-block:: python

from webvtt import WebVTT, Caption

vtt = WebVTT()

vtt.captions.append( Caption(‘00:00:00.500’, ‘00:00:07.000’, ‘Caption line 1\nCaption line 2’) ) vtt.captions.append( Caption(‘00:00:07.000’, ‘00:00:11.890’, [‘Caption line 1’, ‘Caption line 2’]) )

vtt.save(‘captions.vtt’)

or get the content without writing a file

print(vtt.content)

Segmenting for HLS

… code-block:: python

import webvtt

webvtt.segment(‘captions.vtt’, ‘output/path’)

Converting captions from other formats

Supported formats:

SubRip (.srt)
YouTube SBV (.sbv)

… code-block:: python

import webvtt

write captions.vtt next to captions.srt

vtt = webvtt.from_srt(‘captions.srt’) vtt.save()

alternatively in a single line

webvtt.from_sbv(‘captions.sbv’).save()

write captions.srt and captions.sbv next to captions.vtt

vtt = webvtt.read(‘captions.vtt’) vtt.save_as_srt() vtt.save_as_sbv()

CLI

Caption segmentation, shifting, synchronizing, validation and conversion are also available from the command line with the webvtt executable, for WebVTT, SRT and SBV files. Given captions.vtt:

… code-block:: text

WEBVTT

00:00:01.000 --> 00:00:04.000 Hello and welcome.

00:00:06.000 --> 00:00:12.000 This caption spans two segments.

00:00:14.500 --> 00:00:18.000 Thanks for watching!

Segment it into 10-second segments:

$ webvtt segment captions.vtt --output out
$ ls out
fileSequence0.webvtt  fileSequence1.webvtt  prog_index.m3u8

The playlist out/prog_index.m3u8 lists the segments:

… code-block:: text

#EXTM3U #EXT-X-TARGETDURATION:10 #EXT-X-VERSION:3 #EXT-X-PLAYLIST-TYPE:VOD #EXTINF:10.00000, fileSequence0.webvtt #EXTINF:10.00000, fileSequence1.webvtt #EXT-X-ENDLIST

A caption crossing a segment boundary is included in every segment it overlaps, out/fileSequence1.webvtt:

… code-block:: text

WEBVTT X-TIMESTAMP-MAP=MPEGTS:900000,LOCAL:00:00:00.000

00:00:06.000 --> 00:00:12.000 This caption spans two segments.

00:00:14.500 --> 00:00:18.000 Thanks for watching!

Use -d to change the segment duration and -m to change the MPEG-TS value.

Show the captions 1.5 seconds earlier, writing them to a new file:

$ webvtt shift captions.vtt -1.5 --output shifted.vtt

Without --output the shifted captions are written to standard output. Use --start to only shift the captions starting at or after a time, as a timestamp or a number of seconds, and --drop-before-zero to remove the captions moved before the start.

Fix captions that drift out of sync by moving two or more points, here the caption at 00:14.500 to 00:15.850 keeping the first one in place, or by changing the frame rate they are timed for:

$ webvtt sync captions.vtt -p 00:01.000 00:01.000 -p 00:14.500 00:15.850
$ webvtt sync captions.vtt --fps 25 23.976 -o captions.vtt

Check the captions for problems, such as captions out of order, which are printed one per line, with exit status 1 when there are errors:

$ webvtt validate captions.vtt

Convert captions to another format, here by the extension of the output, or with --to:

$ webvtt convert captions.srt -o captions.vtt
$ webvtt convert captions.vtt --to srt --keep-formatting

The commands read SRT and SBV files by their extension, or with --format, and --encoding reads a file in another encoding, as in webvtt shift captions.srt 2 --encoding cp1252 -o captions.srt.

For all the options, run webvtt segment --help, webvtt shift --help, webvtt sync --help, webvtt validate --help, webvtt convert --help or man webvtt, or see the CLI documentation_.

… _CLI documentation: https://webvtt-py.readthedocs.io/en/latest/cli.html