xiejunjie524/handdraw-story-video

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.