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

692

7-day growth

+68

Forks

101

Open issues

0

License

MIT

Last updated

2026-07-23

AI repository intelligence
FR-AI / ANALYSIS

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.

bytec-ai
Featured
bytec-ai GitHub avatar

book-video-factory

A portable multi-account short video production skill for books that manages accounts, scripts, images, voiceovers, subtitles, and final exports through a unified workspace.

Design & Creative
136
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326
gnipbao
Featured
gnipbao GitHub avatar

story-to-handdrawn-video

A Remotion-based tool that converts Chinese story text or ordered hand-drawn images into vertical hand-drawn diary-comic animation with handwritten captions, left-to-right reveals, optional page-curl transitions, and silent H.264 output for post-production dubbing.

AI & Machine LearningAI Agents
683