FreePublished on GitHub

subtitle-translate

Translate existing SRT, VTT, or ASS subtitles into a chosen language while preserving timing. Create bilingual or translation-only subtitle files, then optionally add switchable subtitles to a video or permanently render them into its frames.

OriginalShow the original description

字幕翻译 / 双语字幕：把已有字幕（SRT/VTT/ASS）翻译成目标语言，生成双语（原文+译文）或纯译文字幕，并可软挂载 / 硬烧录进视频。当用户说字幕翻译、翻译字幕、双语字幕、中英字幕、给视频加翻译、SRT 翻译、字幕本地化、把字幕翻成中文/英文、字幕转双语时使用。

翻译由 LLM 完成，时间轴/格式/烧录由 shared/scripts/subtitle_ops.py 确定性处理。与 auto-subtitle 区别：auto-subtitle 是语音识别生成字幕，本 SKILL 是把已有字幕翻译成双语。

ZJU-REAL/Easel

See how to install

Good for

Turning existing subtitles into bilingual subtitles
Creating subtitles containing only the translation
Adding switchable subtitles to a video
Permanently rendering translated subtitles into video frames

Files included (1)

SKILL.md4.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

字幕翻译 / 双语字幕

把已有字幕翻译成目标语言，产出双语（原文+译文）或纯译文字幕，可选烧录进视频。翻译交给 LLM（你自己），确定性部分（解析/合并/格式/时间轴/烧录）全交给 skills/shared/scripts/subtitle_ops.py。不要手拼 ffmpeg，也不要手改时间轴。

只做"已有字幕 → 翻译/双语/烧录"。语音识别生成字幕见 auto-subtitle；通用视频剪辑见 video-editing。

输入

字段	必填	说明
字幕文件	是	`.srt` / `.vtt` / `.ass` 路径（没给就问）
目标语言	是	译成什么语言（如中文 / English / 日本語）
输出形态	否	`双语`（默认）/ `纯译文`
原译顺序	否	双语时原文在上（默认）或译文在上
视频文件	否	给了则可烧录；软挂载（可开关）或硬烧录（烧进画面）

输出（`outputs/主题名/`）

双语 / 纯译文字幕文件（.srt 或 .ass）
若烧录：带字幕的视频（*-sub.mp4）
报告：条数、目标语言、形态、输出路径

执行步骤

脚本路径（相对项目根）：skills/shared/scripts/subtitle_ops.py（每个子命令支持 -h）。

1. 提取待译文本

python skills/shared/scripts/subtitle_ops.py extract -i <字幕> -o /tmp/st_lines.txt

每条字幕一行、行号与顺序固定。记住总行数 N。

2. 逐行翻译（你来做）

读 /tmp/st_lines.txt，逐行翻译成目标语言，写入 /tmp/st_trans.txt：

行数必须严格等于 N，顺序一一对应，不增删空行、不合并、不拆行（脚本会校验，不一致直接报错）。
一行内如原文有多句，整合成一行译文，不要拆成多行。
语气/术语按内容领域走；口语内容译得自然口语，书面内容译得书面。
空行原文对应空行译文（保持占位）。

3. 合并成双语 / 纯译文字幕

# 双语 SRT（原文在上，译文在下）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-bilingual.srt

# 双语 ASS（原文白色较大 / 译文黄色略小，样式更佳，推荐用于硬烧录）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-bilingual.ass --format ass

# 纯译文（不保留原文）
python skills/shared/scripts/subtitle_ops.py merge -i <字幕> --trans /tmp/st_trans.txt \
  -o outputs/主题名/<名>-<lang>.srt --trans-only

--order trans-top 可让译文在上。

4.（可选）烧录进视频

# 硬烧录（烧进画面，推荐用 .ass 保留双语样式）
python skills/shared/scripts/subtitle_ops.py burn -i <视频> \
  --sub outputs/主题名/<名>-bilingual.ass \
  -o outputs/主题名/<名>-sub.mp4

# 软挂载（可在播放器开关，不改画面；mp4→mov_text，mkv→srt）
python skills/shared/scripts/subtitle_ops.py burn -i <视频> \
  --sub outputs/主题名/<名>-bilingual.srt \
  -o outputs/主题名/<名>-sub.mp4 --soft

其它子命令

parse -i <字幕> [-o out.json] — 解析成 JSON（含时间轴），供程序化处理或核对。
build --json <cues.json> -o <字幕> — 从 JSON（cue 带 text 与可选 trans）构建，适合批量/整段翻译回填。
convert -i a.srt -o b.vtt — 格式互转（srt ↔ vtt ↔ ass）。

规则

翻译走 extract → 逐行译 → merge 三步，严守行数一致，绝不让脚本回退到"猜行对应"。
时间轴、字幕条数、格式一律由脚本产出，禁止手改时间戳。
硬烧录中文优先用 .ass（内置 Noto Sans CJK 样式）；若用 srt 硬烧录且中文变方块，burn 加 --font-dir 指向含 CJK 字体的目录。
双语默认原文在上、译文在下（--order 可调）；纯译文用 --trans-only。
产物统一进 outputs/主题名/。

参考来源

字幕翻译工具形态参考开源项目：rockbenben/subtitle-translator（批量双语、译文上下对齐）、 bonigarcia/dualsub（双语合并）、innovationmech/video-translate（软/硬字幕嵌入）。本 SKILL 把"翻译"交给 LLM，只把易错的解析/时间轴/合并/烧录做成确定性脚本。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

ai-image-gen

FreeSummary

Generate images from written descriptions, transform existing images with editing instructions, or create several variations. Choose image dimensions and quantity, then save the results using an OpenAI-compatible service or apimart with your own API key.

Generating an illustration from a written description
Changing an image's background using instructions
Creating several variations of an existing image