Skip to content

SudhirDevOps1/Particle-Morph-Pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

✨ Particle Morph Pro - Hand Gesture Controlled 3D Particle Engine

Particle Morph Pro Version License Status

Made with Three.js MediaPipe TailwindCSS


🎮 Control 20,000+ Particles with Your Hands in Real-Time!

An immersive 3D particle visualization experience powered by AI hand tracking


🚀 Live Demo✨ Features🎯 Gestures📖 Usage🛠️ Installation


🎬 Preview

    ✋ Hand Tracking + Skeleton Visualization
           ↓
    🎨 20,000+ Interactive Particles
           ↓
    💥 Gesture-Controlled Effects
           ↓
    🌈 Beautiful Morphing Shapes

🌟 Features

🖐️ AI-Powered Hand Tracking

Feature Description
🎯 Real-time Detection MediaPipe powered hand tracking at 30+ FPS
🦴 Skeleton Visualization Colorful finger skeleton overlay on camera feed
🎨 Multi-finger Recognition Detects individual finger states accurately
📱 Cross-platform Works on Desktop & Mobile browsers

🎨 Particle System

Feature Description
20,000+ Particles Smooth performance with thousands of particles
🔄 Spring Physics Realistic morphing with velocity-based animation
🌈 Rainbow Mode Continuous color cycling effect
💫 Additive Blending Beautiful glowing particle effects

🎭 14 Unique Shapes

🌸 Flower    ❤️ Heart     ⭐ Star      ∞ Infinity
🦋 Butterfly 🌀 Spiral    👑 Crown     💎 Diamond
🧬 DNA       🌌 Galaxy    🌊 Wave      🔮 Sphere
📦 Cube      ⭕ Rings

⚙️ Customization Controls

  • Particle Size - Adjust particle dimensions
  • Animation Speed - Control morphing velocity
  • Trail Effect - Configure particle trails
  • Boom Power - Set explosion intensity
  • Hand Smoothness - Fine-tune tracking sensitivity
  • Auto Rotate - Toggle automatic rotation
  • Rainbow Mode - Enable color cycling
  • Show Skeleton - Toggle hand skeleton display

🎯 Hand Gestures

Gesture Fingers Action Visual
✌️ Peace Sign 2 Fingers BOOM! 💥 Particle Explosion
🤟 Three Fingers 3 Fingers 360° Rotate 🔄 Full Rotation
👆 Pointer 1 Finger Pointer Mode Precise Control
🖐️ Open Hand 5 Fingers Expand Particles Grow
Fist 0 Fingers Shrink Particles Contract

Gesture Detection Details

// Peace Sign (BOOM) Detection
✌️ = Index UP + Middle UP + Ring DOWN + Pinky DOWN

// Three Fingers (360°) Detection  
🤟 = Index UP + Middle UP + Ring UP + Pinky DOWN

// Fist Detection
 = All fingers curled (hand scale < 0.3)

⌨️ Keyboard Shortcuts

Key Action
Space Trigger BOOM Effect 💥
R Random Shape 🎲
D Reset to Defaults ↩️

🛠️ Installation

Option 1: Direct Use (No Installation)

Simply open index.html in any modern browser!

# Clone the repository
git clone https://github.com/SudhirDevOps1/particle-morph-pro.git

# Navigate to directory
cd particle-morph-pro

# Open in browser
open index.html
# or
start index.html  # Windows

Option 2: Local Server (Recommended)

# Using Python
python -m http.server 8000

# Using Node.js
npx serve .

# Using PHP
php -S localhost:8000

Then open http://localhost:8000 in your browser.


📖 Usage

Getting Started

  1. Allow Camera Access - Grant permission when prompted
  2. Position Your Hand - Hold hand 1-2 feet from camera
  3. Watch the Skeleton - Colored lines appear on your fingers
  4. Try Gestures - Use peace sign, three fingers, fist, etc.
  5. Explore Shapes - Click shape buttons at bottom
  6. Customize - Use settings panel on left side

Settings Panel

┌─────────────────────────┐
│ ⚙️ Controls             │
├─────────────────────────┤
│ Particle Size    [====] │
│ Animation Speed  [====] │
│ Trail Effect     [====] │
│ Boom Power       [====] │
│ Hand Smoothness  [====] │
├─────────────────────────┤
│ Auto Rotate      [ON ]  │
│ Rainbow Mode     [OFF]  │
│ Show Skeleton    [ON ]  │
├─────────────────────────┤
│ [💥 BOOM!]              │
│ [🔄 360° Rotate]        │
│ [🎲 Random Shape]       │
│ [↩️ Reset Default]      │
└─────────────────────────┘

🎨 Color Palette

Color Hex Code Preview
Pink #ff2d55 🔴
Cyan #00f2ff 🔵
Yellow #ffcc00 🟡
White #ffffff
Green #22c55e 🟢
Purple #a855f7 🟣
Orange #f97316 🟠
Rainbow Animated 🌈

🔧 Technical Stack

Technology Purpose
Three.js 3D Rendering & Particles
MediaPipe Hand Tracking AI
TailwindCSS Styling
JavaScript Core Logic
Lucide Icons

📱 Browser Support

Browser Support
Chrome ✅ Full Support
Firefox ✅ Full Support
Safari ✅ Full Support
Edge ✅ Full Support
Mobile Chrome ✅ Full Support
Mobile Safari ✅ Full Support

📂 Project Structure

particle-morph-pro/
│
├── 📄 index.html          # Main application file
├── 📄 README.md           # Documentation (this file)
├── 📄 LICENSE             # MIT License
│
└── 📁 assets/             # (Optional) Additional assets
    ├── 📁 screenshots/
    └── 📁 demos/

🚀 Performance Tips

  1. Close other tabs - Free up GPU memory
  2. Good lighting - Helps hand detection accuracy
  3. Plain background - Improves tracking stability
  4. Keep hand in frame - Maintain consistent tracking
  5. Modern GPU - Better particle performance

🤝 Contributing

Contributions are welcome! Here's how you can help:

# Fork the repository
# Create your feature branch
git checkout -b feature/AmazingFeature

# Commit your changes
git commit -m 'Add some AmazingFeature'

# Push to the branch
git push origin feature/AmazingFeature

# Open a Pull Request

Contribution Ideas

  • Add more particle shapes
  • Implement two-hand tracking
  • Add audio reactivity
  • Create preset themes
  • Add particle physics modes

📜 License

Distributed under the MIT License. See LICENSE for more information.

MIT License

Copyright (c) 2024 Sudhir

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...

👨‍💻 Author

Sudhir

GitHub Portfolio


Full Stack Developer | DevOps Engineer | Creative Technologist

Building innovative solutions at the intersection of AI and Web Technologies


🙏 Acknowledgments


📊 Stats

GitHub stars GitHub forks GitHub watchers


⭐ Star this repo if you found it useful!


Made with ❤️ by Sudhir


Wave

About

An immersive 3D particle visualization experience powered by AI hand tracking

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages