pdoom-video

一首叫 I'm Upping My P(doom) 的歌配的 MV 完整工程。画面全靠代码渲染，歌词一个词一个词地跟着演唱亮起来，像卡拉 OK 字幕。每一帧只由「歌唱到第几秒」决定，所以浏览器里的实时预览和最后导出的 1080p60、4K60 视频一模一样。作者说，概念、歌词对齐、渲染器和每个场景，都是在 Claude Code 里和 Claude Opus 5.5 一起做出来的。

适合谁

• 想做歌词 MV、卡点视频，想看歌词怎么一个字一个字对上的人。
• 想学「画面跟着节拍切」怎么用代码实现的人。
• 会一点 TypeScript 或 three.js（网页上做三维画面的代码库），想拆一个完整 MV 工程的人。

里面有什么，能学到什么

• analysis 文件夹：先把人声和伴奏分开，再把歌词逐词对齐到时间上，用 Whisper 交叉核对；另外测出节拍、重拍和段落。结果存进 data 文件夹，渲染只要这两份数据。
• src/timeline.ts：每个场景挂在某一句歌词上，再吸附到节拍上。
• src/scenes：十几个场景，每个场景一个文件。
• docs/TREATMENT.md 写概念、风格设定和逐段的处理方案；docs/ENGINE.md 讲引擎和场景接口。
• 运动模糊：一帧由很多个子帧平均出来，动得快的东西会拖出连续的残影。

怎么开始

1. 把仓库链接发给 Claude Code，说「帮我把这个项目的预览跑起来」。说明里的做法是进 app 文件夹运行 bun install 和 bunx vite，再在浏览器打开本机 5173 端口。
2. 预览页里按空格播放暂停，按方括号切到上一个、下一个场景，按 l 循环当前场景。
3. 对着画面读 TREATMENT.md 和 timeline.ts，看一句歌词怎么变成一个镜头。
4. 想导出：说明里的命令是在 app 文件夹运行 bun scripts/render.ts video --samples auto --shutter 0.2 --out ../out/pdoom.mp4，出 1080p60；想先出一版快速草稿，把子帧数调低。

要注意

• 代码是 MIT 许可；歌曲和歌词不在这个许可里，归原作者，字体各有自己的许可。
• 要装 bun（一个跑 JavaScript 的工具）、Chrome 和 ffmpeg。
• 4K 版很吃机器：作者在 M5 Pro 上渲整首歌约一小时，内存最高要用二十多 GB。