xiejunjie524 GitHub avatar

handdraw-story-video

xiejunjie524

A tool that converts 7–9 hand-drawn story keyframes into a 35–45 second vertical video with progressive line art and color animation, configurable via JSON and renders with HyperFrames and GSAP.

Stars

410

7-day growth

No data

Forks

68

Open issues

0

License

MIT

Last updated

2026-07-18

Why it is worth attention

It uniquely uses a single color image per scene to automatically extract perfectly aligned line art and animate from left to right without repeated calls to image generation models, while remaining service-agnostic and open-source under MIT.

Who it is for

  • Digital storytellers and illustrators creating short-form video content
  • Content creators for vertical platforms like TikTok, Instagram Reels, and YouTube Shorts
  • Developers seeking a programmable pipeline for animated story videos
  • Educators or marketers needing repeatable, configurable branded storytelling

Use cases

  • Turning a series of hand-drawn illustrations into a social media story video
  • Automating the production of consistent, animated narratives for marketing campaigns
  • Prototyping storyboard animations before committing to full production
  • Creating educational or public service announcement shorts with constrained composition

Strengths

  • No vendor lock-in for image generation, music, or APIs — all dependencies are open or locally managed
  • Built-in validation for duration, duplicate assets, caption length, and font size to prevent common errors
  • One-click batch generation via the provided config example and Codex Skill integration
  • Entire pipeline is scriptable and open-source (MIT license) for customization and extension

Considerations

  • Requires users to manually prepare high-quality hand-drawn keyframes (one per scene) and source their own BGM with proper licenses
  • Strict composition constraints (max 2–3 people, limited text lines) may not suit complex scenes or dense narratives
  • Dependency on HyperFrames, GSAP, FFmpeg, and specific Python/Node.js versions adds setup overhead for non-developers

README quick start

快速开始

Description

Turn hand-drawn story illustrations into 35–45 second line-reveal and gradual-coloring videos with HyperFrames.

Related repositories

Similar projects matched by category, topics, and programming language.

NousResearch
Featured
NousResearch GitHub avatar

hermes-agent

Hermes Agent is an open-source, self-improving AI agent with a built-in learning loop that creates skills from experience, runs across platforms, and supports any LLM provider.

AI & Machine Learning
215,644
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine LearningDeveloper Tools
1,183
joeseesun
Featured
joeseesun GitHub avatar

qiaomu-goal-meta-skill

qiaomu-goal-meta-skill transforms vague requests into a copy-ready Codex /goal command with defaults, verification, boundaries, and pause conditions.

AI & Machine Learning
776