Spaces:
Configuration error
Configuration error
| # AI Manga/Manhwa Parallax Animator | |
| Description | |
| ----------- | |
| AI-powered tool to create dynamic parallax animations from manga or manhwa artwork. The tool analyzes static illustrations and generates cinematic motion effects — parallax layers, camera zooms, shakes, and style-preserving movements — and can export sequences compatible with After Effects for further refinement. | |
| Key Features | |
| ------------ | |
| - AI-Powered Motion Analysis: layer detection, matting, and depth estimation stubs provided | |
| - Dynamic Zoom & Shake Effects: camera-path and procedural shake modules (stubs) | |
| - Style Preservation: designed to keep original line art and halftone textures | |
| - After Effects Integration: JSON export template and exporter class | |
| - CLI for quick iteration and example demo | |
| Quickstart | |
| ---------- | |
| 1. Clone the repository | |
| 2. Create a virtualenv and install dependencies: | |
| pip install -r requirements.txt | |
| 3. Run the demo (replace `input.png` with your artwork): | |
| python -m animator.cli --input examples/sample_art.png --output out.mp4 --export-ae out_ae.json | |
| Project layout | |
| -------------- | |
| - README.md — this file | |
| - LICENSE — MIT license | |
| - requirements.txt — minimal Python deps | |
| - .gitignore | |
| - src/animator/ — core Python package | |
| - core.py — processing pipeline and primary classes | |
| - ae_exporter.py — After Effects export helper | |
| - scripts/cli.py — command-line entrypoint | |
| - examples/demo.py — demo pipeline runner | |
| - aftereffects/export_template.json — AE-friendly JSON structure template | |
| Architecture (high-level) | |
| ------------------------- | |
| 1. Input image -> Preprocessing (resize, normalize) | |
| 2. Layer & matte extraction (segmentation / matting models) | |
| 3. Depth / parallax map estimation | |
| 4. Motion plan generation (paths, camera zooms, shakes) | |
| 5. Frame synthesis / compositing (render frames with transforms + optional style-preservation passes) | |
| 6. Export video (MP4 / WebM) and After Effects JSON for further refinement | |
| Extending the scaffold | |
| ---------------------- | |
| - Replace stubbed implementations in `src/animator/core.py` with your chosen ML models (e.g., U^2-Net for matting, MiDaS or custom depth estimator). | |
| - Implement a GPU-accelerated renderer that composes per-layer transforms and output frames. | |
| - Expand `ae_exporter.py` to match your After Effects scripting workflow or JSON schema expected by third-party AE importers. | |
| License | |
| ------- | |
| MIT. See LICENSE file. | |
| Contributing | |
| ------------ | |
| Pull requests and issues are welcome. For major changes, open an issue first to discuss the plan. |