README.md

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.