你是否有一组精心绘制的手绘故事插画,却苦于不会做动画、不懂视频剪辑、更搞不定节奏和转场?handdraw-story-video 就是为此而生——它不依赖AI生图模型,也不需要逐帧手调,只需7–9张本地彩色母图,就能自动生成35–45秒、节奏流畅、线稿渐显+色彩渐染的竖屏短视频。专为小红书、抖音、微信视频号等平台优化,让手绘创作者真正“所画即所得”。
核心功能
- 全自动线稿提取与对齐:基于OpenCV智能提取每张彩色母图的精准黑白线稿,确保线稿与原图像素级对齐,避免错位抖动
- 电影级渐进式动画逻辑:先从左到右“书写式”显现线稿,再沿同一路径逐步填入低饱和度色彩,营造手绘创作的真实呼吸感
- 开箱即用的竖屏视频模板:默认输出720×960分辨率、30fps、时长40秒,完美适配手机端全屏播放场景
- 智能故事配置校验:自动检查字幕行数、字号范围、画面重复率、总时长偏差等关键指标,提前规避发布失败风险
- 灵活嵌入文字元素:支持画面内道具文字(如黑板上的粉笔字、信封上的收件名)和底部动态字幕双轨叠加,强化叙事表现力
- 完全离线 & 零绑定:不调用任何云端AI服务,不强制使用特定音乐平台或私有API,BGM、字体、图片全部由你自主掌控
适合哪些人用
这款工具特别适合独立插画师、绘本创作者、教育内容开发者、手账博主和中小学美术教师。如果你常在小红书分享“手绘日记”,为孩子制作“故事动画课件”,或想把原创漫画快速转化为短视频引流,又不想被复杂软件劝退——它就是为你量身定制的轻量级生产力工具。无需会Python编程,只要懂基本文件操作和JSON格式,照着文档填几行配置就能出片。
快速上手
整个流程仅需4步,全程本地运行,10分钟内完成首支视频:
- 安装依赖:确保已安装 Python 3.10+、Node.js 18+ 和 FFmpeg;执行
git clone后激活虚拟环境并运行pip install -r requirements.txt与npm install gsap - 准备素材:将7–9张1024×1365左右的彩色母图(PNG格式)放入
assets/images/,按顺序命名(如 scene-01-color.png) - 生成线稿:运行命令
python scripts/make_lineart.py assets/images/scene-01-color.png assets/images/scene-01-line.png,逐张提取对齐线稿 - 配置并导出:修改
story.json填写每幕文案、字幕、BGM路径等;运行npm run build生成 HTML 动画页,再用 FFmpeg 批量导出为 MP4 视频
新手推荐直接参考 中文使用指南 和预置的 config.example.json 模板,连提示词风格都已为你调优好。
项目信息
Turn hand-drawn story illustrations into 35–45 second line-reveal and gradual-coloring videos with HyperFrames.
442
Stars
70
Forks
Python
MIT
编程语言:Python|GitHub Star 数:442|开源协议:MIT|GitHub 项目地址
这是一款真正把“手绘温度”还给创作者的工具——没有黑盒AI、没有订阅陷阱、不牺牲画风控制权,只有清晰流程和可复用的数字画笔。



