🎮 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
✋ Hand Tracking + Skeleton Visualization
↓
🎨 20,000+ Interactive Particles
↓
💥 Gesture-Controlled Effects
↓
🌈 Beautiful Morphing Shapes
| 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 |
| 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 |
🌸 Flower ❤️ Heart ⭐ Star ∞ Infinity
🦋 Butterfly 🌀 Spiral 👑 Crown 💎 Diamond
🧬 DNA 🌌 Galaxy 🌊 Wave 🔮 Sphere
📦 Cube ⭕ Rings
- 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
| 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 |
// 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)| Key | Action |
|---|---|
Space |
Trigger BOOM Effect 💥 |
R |
Random Shape 🎲 |
D |
Reset to Defaults ↩️ |
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# Using Python
python -m http.server 8000
# Using Node.js
npx serve .
# Using PHP
php -S localhost:8000Then open http://localhost:8000 in your browser.
- Allow Camera Access - Grant permission when prompted
- Position Your Hand - Hold hand 1-2 feet from camera
- Watch the Skeleton - Colored lines appear on your fingers
- Try Gestures - Use peace sign, three fingers, fist, etc.
- Explore Shapes - Click shape buttons at bottom
- Customize - Use settings panel on left side
┌─────────────────────────┐
│ ⚙️ 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 | Hex Code | Preview |
|---|---|---|
| Pink | #ff2d55 |
🔴 |
| Cyan | #00f2ff |
🔵 |
| Yellow | #ffcc00 |
🟡 |
| White | #ffffff |
⚪ |
| Green | #22c55e |
🟢 |
| Purple | #a855f7 |
🟣 |
| Orange | #f97316 |
🟠 |
| Rainbow | Animated | 🌈 |
| Browser | Support |
|---|---|
| Chrome | ✅ Full Support |
| Firefox | ✅ Full Support |
| Safari | ✅ Full Support |
| Edge | ✅ Full Support |
| Mobile Chrome | ✅ Full Support |
| Mobile Safari | ✅ Full Support |
particle-morph-pro/
│
├── 📄 index.html # Main application file
├── 📄 README.md # Documentation (this file)
├── 📄 LICENSE # MIT License
│
└── 📁 assets/ # (Optional) Additional assets
├── 📁 screenshots/
└── 📁 demos/
- Close other tabs - Free up GPU memory
- Good lighting - Helps hand detection accuracy
- Plain background - Improves tracking stability
- Keep hand in frame - Maintain consistent tracking
- Modern GPU - Better particle performance
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- Add more particle shapes
- Implement two-hand tracking
- Add audio reactivity
- Create preset themes
- Add particle physics modes
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...
Full Stack Developer | DevOps Engineer | Creative Technologist
Building innovative solutions at the intersection of AI and Web Technologies
- Three.js - Amazing 3D library
- MediaPipe - Powerful ML solutions
- TailwindCSS - Utility-first CSS
- Lucide Icons - Beautiful icons