AgentMatter
EN/中文
提交项目GitHub
Skills · 社区项目

SRT Whiteboard Animation

SRT Whiteboard Animation 读取字幕、拆分分镜、生成统一线稿并按叙事顺序标注区域，最终用连续笔迹和局部上色渲染白板动画 MP4。

2.3k StarsMITPython1 个月前更新
安装与使用 GitHub
01

项目介绍

SRT Whiteboard Animation 是一个面向字幕视频制作的 Agent Skill。它先读取 SRT 并按 25–35 秒建议拆分场景，再让用户确认分镜、线稿和像素级区域标注，最后按字幕叙事顺序连续落墨、局部上色并输出 MP4。它适合知识讲解、课程字幕、故事口播和短视频文案，不是把整张图一次擦出来的简单转场工具。

SRT Whiteboard Animation 猴子山白板手绘场景示例
仓库示例中的完整猴子山场景，展示暖米黄背景、深灰线稿与少量彩色点缀。查看仓库原图
02

核心功能

01

字幕驱动分镜

parse_srt.py 解析字幕并根据目标时长给出分镜建议。

02

语义化区域标注

标注把可见主体与字幕事件关联，并用 sequence、startMs 和 protectedRegions 控制出场。

03

连续笔迹渲染

每个区域按网格或骨架路径连续落墨，再用轮廓扫描或笔刷添彩。

04

多幕合并

merge_scenes.py 按指定顺序把确认后的单幕视频合并为最终成片。

03

安装与使用

下载仓库后先用 prepare_env.py 检查并创建隔离的 Python 环境，再用仓库输出的 ENV_PY 运行后续渲染脚本。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装 SRT Whiteboard Animation Skill。项目地址：https://github.com/geeklee/srt-whiteboard-animation。先阅读 README.md、SKILL.md 和 scripts/prepare_env.py，下载到我指定的项目级或用户级 Skills 目录；在仓库根目录运行 `python scripts/prepare_env.py --check`，缺依赖时再运行 `python scripts/prepare_env.py`。完成后用我提供的 SRT 执行最小 parse_srt.py 验证并报告 ENV_PY 与分镜输出。遇到安装依赖、打开浏览器、本地文件权限、覆盖既有文件或执行其他命令前先向我确认。
01开始前准备
  • 可用的 Python 命令
  • Chrome 或 Edge 用于本地预览台
  • 用户提供的 SRT 文件与后续确认的场景图
  • 项目目录写权限与首次依赖下载网络
02复制安装命令或配置
项目地址：https://github.com/geeklee/srt-whiteboard-animation
复制地址并按照下方步骤完成设置。
03按步骤完成安装
  1. 1
    准备隔离环境

    在仓库根目录运行 `python scripts/prepare_env.py --check`；若缺少环境，再运行 `python scripts/prepare_env.py` 并记录末行 ENV_PY。

  2. 2
    解析字幕并确认分镜

    运行 `python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35`，检查建议场景和对应字幕区间后等待确认。

  3. 3
    标注并预览

    生成与图片同名的 annotation.json，打开 assets/preview.html 载入目录，检查区域、顺序、时间和字幕关联。

  4. 4
    渲染与合并

    用 ENV_PY 运行 render_stream_whiteboard.py；多幕均确认后再用 merge_scenes.py 输出 final.mp4。

如何确认安装成功

在仓库根目录运行 python scripts/prepare_env.py --check；成功时末行应输出 ENV_PY=<路径>。随后用一个 SRT 运行 parse_srt.py，确认输出包含字幕条目、建议分镜与 sceneDurationMs。

使用前注意
  • 后续渲染应使用脚本输出的 ENV_PY 解释器。
  • SKILL.md 要求每个关键阶段完成后等待用户明确确认。
  • 预览台写回文件依赖 Chrome 或 Edge 的 File System Access API。
04

使用场景

SCENARIO 01

知识讲解视频

把课程或科普字幕拆成多幕，让概念和对象按讲述顺序逐步画出。

SCENARIO 02

故事口播

把人物、动作和结果绑定到字幕事件，避免后续角色或情节提前出现。

SCENARIO 03

短视频手绘包装

在统一米黄色纸张和克制配色下输出多幕 MP4，再接入后续剪辑。

05

使用评价

根据 README、SKILL.md、脚本目录和仓库示例判断，它的优势是流程边界、字幕时序和遮罩规则写得具体；代价是步骤多、依赖人工确认与像素级标注。该判断来自公开资料阅读，不代表 AgentMatter 已完成安装或成片实测。

值得一试的地方

  • 从字幕分镜到渲染和合并的链路完整
  • 确认关卡能减少错误分镜带来的返工
  • 提供示例素材、预览台和质量检查清单

使用前要知道

  • 需要 Python 依赖和浏览器本地文件能力
  • 准确区域标注仍需要查看真实图片并人工复核
  • 不适合追求一键生成或写实 3D 视觉的用户
06

README

SRT Whiteboard Animation

Overview

SRT Whiteboard Animation 读取字幕、拆分分镜、生成统一线稿并按叙事顺序标注区域，最终用连续笔迹和局部上色渲染白板动画 MP4。 将 SRT 字幕做成暖米黄纸张底的流式笔迹白板手绘动画 skill：mask 分区遮罩编排 + stream 连续笔迹（ink→color）。

Getting started

  • 下载仓库后先用 prepare_env.py 检查并创建隔离的 Python 环境，再用仓库输出的 ENV_PY 运行后续渲染脚本。
  • 解析 SRT 后按建议时长拆分分镜，每幕只表达一个核心意思。
  • 用 annotation.json 记录区域、字幕、顺序、时间与重叠保护区。
  • 在仓库根目录运行 python scripts/prepare_env.py --check；成功时末行应输出 ENV_PY=<路径>。随后用一个 SRT 运行 parse_srt.py，确认输出包含字幕条目、建议分镜与 sceneDurationMs。

Configuration

项目地址：https://github.com/geeklee/srt-whiteboard-animation
复制地址并按照下方步骤完成设置。
在 GitHub 阅读完整 README →