🖱️ Virtual Mouse

Welcome to the Virtual Mouse! This tool lets you control your computer's mouse using hand gestures captured via your webcam. 🎥

---

🚀 Features

Feature 🧩	Description 📋
🖐️ Hand Gesture Control	Use your hand to move the mouse pointer in real time.
🖱️ Click Actions	Left, right, and double click with fingers gestures.
🧭 Scroll Up / Down	Scroll through pages using finger movements.
🎯 Cursor Movement	Smoothly move the mouse cursor based on hand position.
🔄 Real time Tracking	Fast and responsive tracking using OpenCV and MediaPipe.
🔍 Gesture Recognition	Detect specific finger configurations for different commands.
🧰 Easy Setup & Customization	Simple to install, run, and tweak gesture mappings.
🧑‍💻 Python Powered	Entirely built using Python and open source libraries.
📷 Webcam Integration	Uses your computer's webcam.

---

🛠️ Tech Stack

Technology ⚙️	Purpose 📋
🐍 Python 3	Core programming language
🎥 OpenCV	Video capture and image processing
✋ MediaPipe	Hand tracking and gesture detection
🖱️ PyAutoGUI	Simulate mouse actions
📦 NumPy	Efficient numerical operations

---

💻 How It Works

1. 🎥 Capture video from the webcam in real time.
2. ✋ Detect hand landmarks using MediaPipe.
3. 🖱️ Index finger tip controls the cursor position on the screen.

✋ Gesture Based Mouse Actions

Gesture 👋	Fingers State 🖐️	Distance Condition 📏
Left Click	Index ✅, Middle ✅, Pinky ❌	Index ↔️ Middle < 25px
Right Click	Index ✅, Middle ✅, Pinky ✅	Index ↔️ Middle < 25px
Scroll Down	Index ✅, Middle ✅, Pinky ❌, Thumb ✅	Index ↔️ Middle < 25px
Scroll Up	Index ✅, Middle ✅, Pinky ✅, Thumb ✅	Index ↔️ Middle < 25px
Double Click	Index ✅, Middle ❌, Pinky ❌, Thumb ✅	Not Required

• ✅ = Finger Up
• ❌ = Finger Down
• ↔️ = Distance between fingertips

---

📦 Installation

1. Clone the repository

   git clone https://github.com/KrishBharadwaj5678/VirtualMouse.git

2. Navigate into the project directory

   cd VirtualMouse

3. Install the required dependencies

   pip install -r requirements.txt

---

▶️ Run the Project

1. Start the application

   python app.py

---

🤝 Contributing

Contributions are welcome! 🙌

1. Fork the Repository 🍴

2. Clone Your Fork 📥

   git clone https://github.com/KrishBharadwaj5678/VirtualMouse.git
   cd VirtualMouse

3. Create a New Branch 🌿

   git checkout -b feature/your-feature-name

4. Make Your Changes 🧠

5. Commit Your Changes 💾

   git add .
   git commit -m "Add: Short description of your change"

6. Push to Your Fork 🚀

   git push origin feature/your-feature-name

7. Open a Pull Request 📬

   • Go to the repo and open a Pull Request from your branch.