GroupSketch: Multi-Object Sketch Animation with Grouping and Motion Trajectory Priors
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
- Clone the repository:
git clone https://github.com/Yukinonooo/GroupSketch.git
cd GroupSketch- Set up the conda environment:
conda env create -f requirements.txt
conda activate groupsketch- 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
- Launch the web application:
python app.py- Upload your sketch:
- Support formats: SVG
- Define object groups:
- Use the interactive Canvas to group related objects
- Set motion trajectories for each group
- 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
📹 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!
