GroupSketch: Multi-Object Sketch Animation with Grouping and Motion Trajectory Priors

August 14, 2025 · View on GitHub

Project Website

title

This repository contains the official implementation of our ACM MM 2025 paper, "Multi-Object Sketch Animation with Grouping and Motion Trajectory Priors."

🔥 Latest Update

  • 2025.08: 🎉 We released the code for GroupSketch. 🎉
  • 2025.07: 🎉 GroupSketch accepted by ACM MM 2025. 🎉

🌟 Highlights

  • Novel Two-Stage Pipeline: Combines user-defined grouping with motion trajectory priors for multi-object sketch animation
  • Group-based Displacement Network: Features Context-conditioned Feature Enhancement for improved temporal consistency
  • Superior Performance: Significantly outperforms existing methods in visual quality and temporal consistency for complex multi-object scenarios
  • Interactive Web Interface: User-friendly Flask-based web application for easy sketch animation creation

🚀 Getting Started

Installation

  1. Clone the repository:
git clone https://github.com/Yukinonooo/GroupSketch.git
cd GroupSketch
  1. Set up the conda environment:
conda env create -f requirements.txt
conda activate groupsketch
  1. Install PyDiffVG (Essential for vector graphics rendering):
git clone https://github.com/BachiLi/diffvg.git
cd diffvg
git submodule update --init --recursive
python setup.py install

🎨 Usage

Quick Start - Web Interface

  1. Launch the web application:
python app.py
  1. Upload your sketch:
  • Support formats: SVG
  1. Define object groups:
  • Use the interactive Canvas to group related objects
  • Set motion trajectories for each group
  1. Generate animation:
  • Configure animation parameters (duration, frames, etc.)
  • Click "Generate Animation" to start processing

🎬 Interactive Tutorial

Experience GroupSketch in Action: Watch our comprehensive walkthrough demonstrating the complete workflow from sketch upload to animation generation.

🖱️ Canvas Web Interface Demo

Watch the Tutorial

📹 Click here to download and watch the complete tutorial

Complete end-to-end demonstration of the GroupSketch web interface, showcasing object grouping, motion trajectory definition, and real-time animation generation.

💡 Pro Tip: Follow along with the tutorial using your own sketches to master the GroupSketch workflow!

📊 Features

Core Capabilities

  • ✅ Multi-object sketch animation with automatic object detection
  • ✅ Group-based motion control for complex scene animation
  • ✅ Temporal consistency through advanced neural networks
  • ✅ Real-time preview in web interface
  • ✅ Batch processing for multiple sketches
  • ✅ SVG export for scalable vector animations

Supported Input Formats

  • SVG: Native vector format

Output Formats

  • MP4 video: Frame-based animation export
  • GIF: Animated GIF for web sharing
  • SVG sequence: Individual SVG frames
  • PNG sequence: Rasterized frame sequence

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💘 Acknowledgements

This project is built upon the incredible work of:

Special thanks to the authors and contributors of both projects!

📬 Contact

For questions, bug reports, or collaboration inquiries, please feel free to open an issue or submit a pull request on GitHub.

Star ⭐ this repository if you find it helpful!