Repolode
masihsultani

masihsultani/whiteboard-animator

将白板风格图片渲染为手绘书写动画 MP4 的命令行工具与 Python 库,可按配音节奏调整绘制速度。

Star
242
Fork
27
未关闭 Issue
3
最近提交
上个月

这是什么?

whiteboard-animator 接收黑色线条、白色背景的成品图片,生成一段模拟手绘过程的视频。文字会逐词书写,轮廓被描绘出来,大面积填充使用笔刷或斜向扫描,树状线稿则按笔画顺序逐段绘制。渲染在 CPU 上完成,不需要训练模型或 API 密钥,内置的 ONNX 文本检测模型用于区分文字与图形。

项目可通过 PyPI 安装,提供 `whiteboard-animate` 命令行工具,也提供 Python 接口,支持多个场景拼接成一个视频,并可调整淡入淡出和填充参数。视频输出依赖 FFmpeg,需要在 PATH 中可用。每个场景可以附带配音,绘制过程会自动对齐到音频时长;也可以编写 JSON 区域规划,依据标注文字估算节奏。

该工具最适合简洁的马克笔风格、平涂配色的图片,照片、渐变或带纹理及彩色背景的图片不适用。

核心功能

  • 01逐词书写文字,并自动描绘轮廓。
  • 02根据填充区域大小选择笔刷或扫描式绘制。
  • 03内置文本检测模型,在 CPU 上运行,无需 GPU 或 API 密钥。
  • 04可根据配音文件时长安排绘制进度。
  • 05通过 FFmpeg 将多个场景拼接为一个 MP4。
  • 06同时提供命令行工具和可调参数的 Python 接口。

适用场景

  • 为课程或讲解视频制作图表、白板草图的手绘书写动画。
  • 为带旁白的教学内容添加手绘逐步呈现效果。
  • 通过命令行批量渲染一系列插图场景,合并为一个视频。

快速上手

  1. 1

    安装 FFmpeg(macOS 使用 Homebrew)

    brew install ffmpeg
  2. 2

    从 PyPI 安装该包

    pip install whiteboard-animator
  3. 3

    将白板图片渲染为 8 秒的 MP4

    whiteboard-animate sketch.png --duration 8 -o sketch.mp4

使用前须知

  • 需要单独安装 FFmpeg 和 ffprobe 并加入 PATH。
  • 最适合白底、马克笔风格的线稿;照片和彩色背景效果不佳。
  • 配音节奏根据文本估算,并未与语音对齐,画面时间可能与配音不同步。

标签

常见问题

whiteboard-animator 是什么?
将白板风格图片渲染为手绘书写动画 MP4 的命令行工具与 Python 库,可按配音节奏调整绘制速度。 whiteboard-animator 接收黑色线条、白色背景的成品图片,生成一段模拟手绘过程的视频。文字会逐词书写,轮廓被描绘出来,大面积填充使用笔刷或斜向扫描,树状线稿则按笔画顺序逐段绘制。渲染在 CPU 上完成,不需要训练模型或 API 密钥,内置的 ONNX 文本检测模型用于区分文字与图形。
whiteboard-animator 可以免费使用吗?用的什么许可证?
whiteboard-animator 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
whiteboard-animator 还在维护吗?
半年内有更新。whiteboard-animator 最近一次提交是在 2026年9月8日。
whiteboard-animator 适合用来做什么?
为课程或讲解视频制作图表、白板草图的手绘书写动画。 为带旁白的教学内容添加手绘逐步呈现效果。 通过命令行批量渲染一系列插图场景,合并为一个视频。
whiteboard-animator 怎么安装和运行?
安装 FFmpeg(macOS 使用 Homebrew): brew install ffmpeg 从 PyPI 安装该包: pip install whiteboard-animator 将白板图片渲染为 8 秒的 MP4: whiteboard-animate sketch.png --duration 8 -o sketch.mp4
在哪里获取 whiteboard-animator?
源代码和安装说明在 GitHub 上:https://github.com/masihsultani/whiteboard-animator

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目