OpenBBQ

导出与烧录

从工作区导出 SRT 或 ASS 字幕文件,并把带样式的字幕烧录进视频画面。

导出是把校对好的工作区文件变成字幕文件,可以交给任何播放器或剪辑软件;烧录更进一步,把字幕写进画面本身。这两步都排在文字确认无误之后——通常先做可视化校对,再到这里。

导出模式

openbbq export 读取字幕行(cues.json);需要译文时再读取一份翻译工作表。

模式命令文件里的字幕
仅原文openbbq export原文
仅译文openbbq export --to zh译文
双语openbbq export --to zh --mode bilingual译文在上、原文在下

不传 --to 时默认是原文模式;传了 --to 默认是译文模式。

SRT

SRT 是默认格式——几乎所有播放器都认识的普通字幕文件,写到 out/<lang>.srt

openbbq export --workspace workspaces/demo
openbbq export --workspace workspaces/demo --to zh --mode bilingual

ASS 与预设

想要带样式的双语字幕,或者打算烧录时,使用 ASS:

openbbq export \
  --workspace workspaces/demo \
  --to zh \
  --mode bilingual \
  --format ass \
  --ass-preset fansub

预设是一套现成的排版——字体、字号和两行的位置:

预设用途
default常规 16:9 横屏视频
fansub译文行更醒目
fansub-compact更小、位置上移的双语字幕组合——只有你明确要求时才会使用,不会被自动选中
mobile9:16 竖屏画布,底部安全区更大

--ass-preset 只能和 --format ass 一起使用。Mobile 预设只改变渲染方式,不会帮你缩短过长的字幕。超出阅读速度或行容量检查的内容,必须修改或重新切分——比如通过 translate init 的覆盖选项。详见翻译工作流

校对关卡

存在对应的 review.zh.jsonreview.source.json 时,导出要求该范围内每一行字幕都已校对且内容最新。重新打开编辑器,完成剩余的行或刷新过期的行:

openbbq review --to zh --workspace workspaces/demo

只有有意生成草稿时才用 --allow-unreviewed 放行导出;它不会把任何行标为已校对。关卡细节见可视化校对

译文不完整

有任何一行的译文为空时,译文导出和双语导出默认会失败。先检查:

openbbq translate check zh --workspace workspaces/demo

有意生成草稿时,--allow-missing 会让空行回退为原文:

openbbq export --to zh --mode bilingual --allow-missing --workspace workspaces/demo

未处理的质量项

导出还会拦住未处理的质量项:缺失的行、超过长度预算的行、预算为零的行、术语表问题,以及尚未审校的行。每行译文都有长度预算——按舒服的阅读速度能容纳的字符数。确认要出草稿时,可以传 --allow-quality-warnings 照常导出。

自定义输出路径

openbbq export --to zh --format ass --output out/review.ass --workspace workspaces/demo

相对路径在工作区内解析,也可以使用绝对路径。

把字幕烧进画面

openbbq burn 使用最近一次 ASS 导出:

openbbq burn --workspace workspaces/demo

也可以自己指定文件:

openbbq burn \
  --workspace workspaces/demo \
  --subtitle out/review.ass \
  --output out/final.mp4

默认输出名由字幕文件推导——out/zh.ass 变成 out/zh-burned.mp4

需要的条件:

  • 来源必须是视频,音频工作区不能烧录。
  • 字幕文件必须是 ASS——先用 --format ass 导出。
  • FFmpeg 要带有 asssubtitles 滤镜。如果符合要求的 FFmpeg 不在 PATH 首位,直接指给它:
openbbq burn --workspace workspaces/demo --ffmpeg /path/to/ffmpeg

烧录需要几分钟,不是几秒钟。进度会写进工作区 manifest,可以在另一个终端查看:

openbbq --json status --workspace workspaces/demo

如果 burn 拒绝了你的设置,或者提示缺少滤镜,看故障排查

记录在案

导出会为字幕行、译文、校对状态和 ASS 文件记录内容哈希——也就是指纹。烧录前会核对这些指纹:工作区里的 ASS 如果被改动过,或者根本没有记录,burn 会拒绝——重新导出,或者用 --subtitle 显式传入文件。--allow-stale 只留给有意为之的手工草稿。

烧录成功后,会记下最终 MP4 的哈希,以及所用源视频和 ASS 的确切哈希——这份熟肉用了哪些原料,随时有据可查。

上桌之前

openbbq delivery check --to zh

发布前的最后一道关卡。它会重新核验哪些内容,完整图景见质量关卡

本页目录