xiejunjie524/handdraw-story-video — explained in plain English
Analysis updated 2026-05-18
Turn a set of hand-drawn story illustrations into a short vertical animated video.
Automate a line-art reveal and gradual-coloring effect without manual video editing.
Build short-form illustrated story content for vertical video platforms.
Install it as a Codex Skill to generate story videos from a text prompt.
| xiejunjie524/handdraw-story-video | mishakorzik/free-proxy | sapientinc/hrm-text | |
|---|---|---|---|
| Stars | 616 | 617 | 617 |
| Language | Python | Python | Python |
| Last pushed | — | 2023-08-12 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | hard | easy | hard |
| Complexity | 3/5 | 2/5 | 5/5 |
| Audience | designer | developer | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires Python, Node.js, FFmpeg, HyperFrames, and GSAP all installed and configured together.
Handdraw Story Video is a tool that turns a set of seven to nine hand drawn story illustrations into a short vertical video, usually 35 to 45 seconds long. The video first reveals a black and white line drawing of each scene from left to right, then gradually fills it in with soft, low saturation color moving in the same direction. It is aimed at vertical video platforms and defaults to a 40 second, 720 by 960, 30 frames per second output. Each scene in the story starts from one full color master image, and the tool extracts a matching line only version of that same image locally, so the two versions stay perfectly aligned. Both the line reveal and the coloring always move left to right and the tool does not call an image generation model more than once per scene. Story text captions and small labels on props inside the frame are both optional. Before rendering, the tool automatically checks things like total duration, duplicate images, how many lines of caption text there are, and whether the font size falls in an acceptable range. The project does not tie itself to any particular image generation service, music source, or private API key. To use it, someone needs Python 3.10 or newer, Node.js 18 or newer, FFmpeg, the HyperFrames package, and GSAP 3, a JavaScript animation library installed through npm. After cloning the repository and installing dependencies, a person copies a story template, fills in scene text and image paths, generates a matching line drawing for each color image with a helper script, sets up a HyperFrames folder with GSAP included, then builds an HTML page from the story file and renders it to a video file with the HyperFrames command line tool. The repository can also be installed as a Codex Skill by copying or linking it into a skills folder, after which someone can trigger it with a request like making a 40 second line art story that gradually gains color. The code itself is released under MIT, but generated images, fonts, GSAP, and music are not automatically covered by that license and must follow their own sources' terms.
A tool that turns hand-drawn story illustrations into short vertical videos with a line-reveal and gradual-coloring animation.
Mainly Python. The stack also includes Python, Node.js, HyperFrames.
The code is free to use for any purpose, but generated images, fonts, GSAP, and music each follow their own separate license terms.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly designer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.