🎭 Face Detector

Transform your face into something extraordinary! A real time face detection app with unique and fun AR mask filters powered by OpenCV and MediaPipe.

✨ What Makes This Special?

Ever wanted to become a dragon? Or maybe try on a Cyber? Our Face Detector doesnt just detect faces - it transforms them! With our collection of unique AR masks, you can:

• 🐲 Dragon
• 👑 Venetian
• 😈 Demon
• 🤖 Cyber

All filters work in real time and adapt to your facial movements!

🚀 Quick Start

Option 1: Using Anaconda (Recommended)

# Clone the repository
git clone https://github.com/rexzea/Face-Detector.git

# Install dependencies
conda install -c conda-forge opencv
conda install mediapipe
pip install -r requirements.txt

Option 2: Using pip

# Clone the repository
git clone https://github.com/rexzea/Face-Detector.git

# Install dependencies
pip install -r requirements.txt

🎮 Controls Casual Face Detector

• q - Break
• m - Show Mesh
• c - Show Contours
• s - Show Metrics
• p - Screenshot

🎮 Controls Filter Face Detector

• q - Break
• n - Change Mask
• s - Screenshot

🛠️ Technical Details

Core Technologies

• OpenCV - For realtime image processing and camera handling
• MediaPipe - For precise facial landmark detection
• Python 3.8+ - Core programming language
• NumPy - For efficient numerical operations

Features

• Realtime face detection and tracking
• unique AR mask filters
• Simple filter animations
• Multi face support
• Photo capture functionality
• Filter customization options

🔧 Troubleshooting

Having issues? Here are some common solutions:

1. Camera not working?

   • Check your camera specifications

2. Slow performance?

   • Make sure youre using GPU enabled environment (if available)
   • Lower the resolution in settings
   • Close other camera applications

3. Dependencies issues?

   # Try using Anaconda environment (recommended)
   conda create -n face_detector python=3.8
   conda activate face_detector
   conda install -c conda-forge opencv mediapipe

🤝 Contributing

Got ideas for making this more? Contributions are welcome!

1. 🍴 Fork the repository
2. 🌱 Create your feature branch (git checkout -b feature/NewFeature)
3. 💫 Add your changes (git add .)
4. 📝 Commit your changes (git commit -m 'Add some NewFeature')
5. 🚀 Push to the branch (git push origin feature/NewFeature)
6. 🎉 Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👏 Acknowledgments

• MediaPipe team for their amazing facial landmark detection
• OpenCV community for computer vision tools
• All our amazing contributors

📞 Support & Contact

Need assistance? Reach out through:

• 📧 Email: futzfary@gmail.com
• 📱 Phone: +62 898-8610-455
• 💬 GitHub Issues: Open a new issue in the repository

🌟 Crafted with ❤️ by Rexzea 🌟

---

Show Your Support

⭐ Star this repository if you find it helpful! ⭐

Report Bug · Request Feature