Video Lyrics Subtitle

🎵 视频歌词字幕生成 Skill

视频歌词字幕生成引擎：从歌词文本 + 时间轴 → SRT/ASS 字幕 → FFmpeg 烧录到视频

触发词

歌词字幕、lyrics subtitle、字幕烧录、字幕生成、SRT、ASS、bilingual subtitle、双语字幕、字幕文件、字幕制作

功能概述

从歌词文本（纯文本或 LRC 格式）+ 时间轴信息，生成 SRT/ASS 字幕文件，并可通过 FFmpeg 烧录到视频中。

核心 Pipeline

lyrics.txt + audio.mp3
  → generate_srt.py   (生成 SRT 时间轴)
  → generate_ass.py   (可选：生成 ASS 高级样式 / KTV 效果)
  → burn_subtitles.sh (FFmpeg 烧录到视频)
  → final_with_subtitles.mp4

脚本位置

所有脚本在 scripts/ 子目录下：

标准输入

generate_srt.py — SRT 字幕生成

用法

python3 scripts/generate_srt.py <lyrics_file> [options]

选项

输入格式支持

1. LRC 格式（带时间戳）

[00:00.00]（纯音乐前奏）
[00:15.00]樱花落尽时 花瓣纷飞如雪
[00:20.00]你的笑容 在记忆中凋谢

2. 纯文本格式（等间隔分配）

需要 --audio 或 --duration 指定总时长，每行歌词等间隔分配时间。 空行表示纯音乐段，自动标注 (纯音乐)。

3. JSON 时间轴格式

通过 --json-timeline 传入带 sections[].lines[] 结构的 JSON 文件， 支持精确的 start/end 时间。

SRT 生成规则

• 每行歌词对应一条 SRT 条目
• 空行 / 纯音乐段自动标注 (纯音乐)
• 双语模式：原文行在上，翻译行在下，同一条目内用 \N 分隔
• 时间格式：HH:MM:SS,mmm（SRT 标准）

示例

# LRC 歌词 → SRT
python3 scripts/generate_srt.py lyrics/lyrics.lrc -o subtitles/lyrics.srt

# 纯文本歌词 + 音频时长 → SRT
python3 scripts/generate_srt.py lyrics/lyrics.txt --audio audio/song_final.mp3 -o subtitles/lyrics.srt

# 双语字幕
python3 scripts/generate_srt.py lyrics/lyrics.txt --audio audio/song_final.mp3 \
  --bilingual lyrics/lyrics_cn.txt -o subtitles/lyrics_bilingual.srt

# JSON 时间轴 → SRT
python3 scripts/generate_srt.py lyrics/lyrics.txt \
  --json-timeline script/chloe_lyrics_parsed.json \
  -o subtitles/lyrics.srt

generate_ass.py — ASS 高级字幕生成

用法

python3 scripts/generate_ass.py <srt_file> [options]

选项

ASS 样式

simple 模式

• 底部居中显示
• 白色文字 + 黑色描边
• 半透明背景条

ktv 模式

• 逐字高亮效果（\kt 标签）
• 播放时文字从灰色变为亮色
• 适合 KTV / 卡拉 OK 场景

示例

# 简单样式
python3 scripts/generate_ass.py subtitles/lyrics.srt -o subtitles/lyrics.ass

# KTV 样式
python3 scripts/generate_ass.py subtitles/lyrics.srt --style ktv -o subtitles/lyrics.ass

# 自定义字体和颜色
python3 scripts/generate_ass.py subtitles/lyrics.srt \
  --font "Source Han Sans CN" --fontsize 52 \
  --primary-color "#FFD700" -o subtitles/lyrics.ass

burn_subtitles.sh — FFmpeg 字幕烧录

用法

bash scripts/burn_subtitles.sh <video_file> <subtitle_file> [output_file]

功能

• 自动检测字幕格式（SRT / ASS）
• 调用 FFmpeg 硬字幕烧录
• 默认输出文件名：<video>_with_subtitles.mp4
• FFmpeg 路径：~/tools/ffmpeg

FFmpeg 命令

# SRT 硬字幕
ffmpeg -i video.mp4 -vf "subtitles=lyrics.srt" -c:a copy output.mp4

# ASS 硬字幕
ffmpeg -i video.mp4 -vf "ass=lyrics.ass" -c:a copy output.mp4

示例

# 烧录 SRT 字幕
bash scripts/burn_subtitles.sh video/phase1_preview.mp4 subtitles/lyrics.srt video/final_with_subtitles.mp4

# 烧录 ASS 字幕
bash scripts/burn_subtitles.sh video/phase1_preview.mp4 subtitles/lyrics.ass video/final_with_subtitles.mp4

📁 规范 MV 项目文件结构

所有 MV 项目遵循以下文件结构：

~/clawd/projects/MediaClaw/output/<project-name>/
├── lyrics/                    # 🎵 歌词（必须有）
│   ├── lyrics.txt             # 歌词原文（纯文本或LRC）
│   ├── lyrics_cn.txt          # 中文翻译（可选）
│   └── lyrics.json            # 带时间轴的JSON（程序生成）
├── subtitles/                 # 📝 字幕文件（程序生成）
│   ├── lyrics.srt             # SRT格式
│   ├── lyrics_bilingual.srt   # 双语SRT
│   └── lyrics.ass             # ASS格式（KTV效果）
├── audio/                     # 🎶 音频
│   └── song_final.mp3         # 最终版音频
├── video/                     # 🎬 视频
│   ├── clips/                 # 各clip片段
│   └── final_with_subtitles.mp4  # 最终带字幕视频
├── frames/                    # 🖼️ 参考帧图片
└── script/                    # 📜 剧本/计划
    ├── mv_script.json         # MV脚本
    └── edit_plan.json         # 剪辑计划

文件命名铁律 ⚠️

禁止随意命名（如 sub01.srt、lyrics_raw_v2.txt、final_v3_new.mp4）。 所有文件必须遵循以上命名规范。

完整工作流示例

# 设置项目路径
PROJECT=~/clawd/projects/MediaClaw/output/chloe-sakura-mv
SKILL=~/clawd/skills/video-lyrics-subtitle

# 1. 生成 SRT 字幕（从 LRC 歌词）
python3 $SKILL/scripts/generate_srt.py \
  $PROJECT/lyrics/lyrics.txt \
  --json-timeline $PROJECT/script/sakura_mv_final.json \
  -o $PROJECT/subtitles/lyrics.srt

# 2. 生成 ASS 字幕（KTV 风格）
python3 $SKILL/scripts/generate_ass.py \
  $PROJECT/subtitles/lyrics.srt \
  --style ktv \
  -o $PROJECT/subtitles/lyrics.ass

# 3. 烧录字幕到视频
bash $SKILL/scripts/burn_subtitles.sh \
  $PROJECT/video/phase1_preview_sakura_mv.mp4 \
  $PROJECT/subtitles/lyrics.ass \
  $PROJECT/video/final_with_subtitles.mp4