@gosavetool/subtitles

中文文档
1.0.0发布于 2026/11/01MITTypeScriptCommonJS零依赖

解析,转换,移位和修复SRT和WebVTT字幕。零依赖,使用CLI。

中文使用文档
文档目录6 节
  1. 安装
  2. 将SRT转换为WebVTT
  3. 利用线索
  4. 命令行界面
  5. 相关
  6. 许可证

@gosavetool /字幕

解析、转换、移位和修复 SRT 和 WebVTT 字幕。零依赖,在Node和浏览器中工作,并附带一个小CLI。

由 GoSaveTool. 喜欢视觉编辑器?这个 VTT字幕生成器 根据浏览器中的视频计时字幕。

安装

npm install @gosavetool/subtitles

将SRT转换为WebVTT

const { convert } = require('@gosavetool/subtitles');

const vtt = convert(fs.readFileSync('movie.srt', 'utf8'), 'vtt');
const srt = convert(fs.readFileSync('movie.vtt', 'utf8'), 'srt');

利用线索

const { parse, shift, repair, toSrt, toVtt } = require('@gosavetool/subtitles');

const cues = parse(text);           // [{ start: 1000, end: 3500, settings: '', text: 'Hello' }, …]
const later = shift(cues, 1500);    // every cue 1.5 s later (negative = earlier)
const { cues: fixed, fixed: n } = repair(cues); // sort, fix overlaps and bad end times, drop empty cues
fs.writeFileSync('out.srt', toSrt(fixed));
函数返回
parse(text)SRT或WebVTT文本的提示,以毫秒为单位
toSrt(cues) / toVtt(cues)字幕文本;SRT从1开始重新编号
convert(text, 'srt' | 'vtt')在一次呼叫中转换文本
shift(cues, ms)线索移动 ms;0之前的球杆被剪掉或丢弃
repair(cues, { minDuration }){ cues, fixed } 随着数量的变化
isVtt(text)true 当文本以 WEBVTT
toMs('00:01:02,500') / fromMs(62500, '.')时间戳↔毫秒

包括TypeScript类型。

命令行界面

npx @gosavetool/subtitles convert movie.srt --to vtt
npx @gosavetool/subtitles shift movie.srt -1.5
npx @gosavetool/subtitles repair movie.vtt
npx @gosavetool/subtitles info movie.srt

-o out.vtt 写入另一个文件, --stdout 输出结果。

许可证

麻省理工学院

版本与发布记录

@gosavetool/subtitles 共发布 2 个版本,首次发布于 2026/11/01;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.0latest2026/11/012 天前
0.0.0-stage2026/11/012 天前

关于 @gosavetool/subtitles 的常见问题

@gosavetool/subtitles 是什么?

解析,转换,移位和修复SRT和WebVTT字幕。零依赖,使用CLI。

如何安装 @gosavetool/subtitles?

在项目目录运行 npm install @gosavetool/subtitles,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 subtitles,可以用 npx subtitles 直接运行。

@gosavetool/subtitles 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gosavetool/subtitles 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@gosavetool/subtitles 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=14。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gosavetool/subtitles 可以商用吗?

@gosavetool/subtitles 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gosavetool/subtitles 还在维护吗?

最新版本 1.0.0 发布于 2026/11/01(2 天前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。