🎵 视频歌词字幕生成 Skill Skill

🎵 视频歌词字幕生成 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/ 子目录下：

| 脚本 | 功能 | |------|------| | scripts/generate_srt.py | 从歌词文本 + 时间轴生成 SRT 字幕 | | scripts/generate_ass.py | SRT → ASS 转换（支持 KTV 高亮） | | scripts/burn_subtitles.sh | FFmpeg 烧录字幕到视频 |

标准输入

| 输入 | 文件 | 说明 | |------|------|------| | 歌词原文 | lyrics/lyrics.txt | 纯文本或 LRC 格式带时间戳 | | 中文翻译 | lyrics/lyrics_cn.txt | 可选，用于双语字幕 | | 音频文件 | audio/song_final.mp3 | 用于获取总时长（纯文本歌词时） | | 视频文件 | video/*.mp4 | 烧录目标 |

generate_srt.py — SRT 字幕生成

用法

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

选项

| 参数 | 说明 | |------|------| | lyrics_file | 歌词文件路径（LRC 或纯文本） | | --audio <file> | 音频文件，用于获取总时长（纯文本歌词时必须） | | --duration <seconds> | 总时长（秒），替代 --audio | | --bilingual <cn_file> | 中文翻译文件，生成双语 SRT | | --json-timeline <file> | 带时间轴的 JSON 文件（如 chloe_lyrics_parsed.json） | | -o / --output <file> | 输出 SRT 文件路径（默认 stdout） |

输入格式支持

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]

选项

| 参数 | 说明 | |------|------| | srt_file | 输入 SRT 文件路径 | | --style <ktv\|simple> | 样式模式（默认 simple） | | --font <name> | 字体名称（默认 Noto Sans CJK SC） | | --fontsize <size> | 字体大小（默认 48） | | --primary-color <hex> | 主文字颜色（默认 #FFFFFF） | | --outline-color <hex> | 描边颜色（默认 #000000） | | --back-color <hex> | 背景色（默认 #80000000 半透明黑） | | -o / --output <file> | 输出 ASS 文件路径（默认同名 .ass） |

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         # 剪辑计划

文件命名铁律 ⚠️

| 内容 | 固定路径 | 说明 | |------|----------|------| | 歌词原文 | lyrics/lyrics.txt | 纯文本或 LRC | | 中文翻译 | lyrics/lyrics_cn.txt | 可选 | | SRT 字幕 | subtitles/lyrics.srt | 单语 | | 双语 SRT | subtitles/lyrics_bilingual.srt | 双语 | | ASS 字幕 | subtitles/lyrics.ass | KTV 效果 | | 最终视频 | video/final_with_subtitles.mp4 | 带字幕成品 |

禁止随意命名（如 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

Agent Skills: 🎵 视频歌词字幕生成 Skill

Install this agent skill to your local

Skill Files