https://github.com/krishbharadwaj5678/virtualmouse
https://github.com/krishbharadwaj5678/virtualmouse
computer-vision cv2 cvzone hand-tracking mouse numpy opencv python threading time virtual-mouse
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/krishbharadwaj5678/virtualmouse
- Owner: KrishBharadwaj5678
- Created: 2025-05-26T08:14:36.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-26T10:15:01.000Z (5 months ago)
- Last Synced: 2025-05-26T10:42:49.816Z (5 months ago)
- Topics: computer-vision, cv2, cvzone, hand-tracking, mouse, numpy, opencv, python, threading, time, virtual-mouse
- Language: Python
- Homepage:
- Size: 8.53 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🖱️ 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**
```bash
git clone https://github.com/KrishBharadwaj5678/VirtualMouse.git
```
2. **Navigate into the project directory**
```bash
cd VirtualMouse
```
3. **Install the required dependencies**
```bash
pip install -r requirements.txt
```
---
## ▶️ Run the Project
1. **Start the application**
```bash
python app.py
```
---
## 🤝 Contributing
Contributions are welcome! 🙌
1. **Fork the Repository** 🍴
2. **Clone Your Fork** 📥
```bash
git clone https://github.com/KrishBharadwaj5678/VirtualMouse.git
cd VirtualMouse
```
3. **Create a New Branch** 🌿
```bash
git checkout -b feature/your-feature-name
```
4. **Make Your Changes** 🧠
5. **Commit Your Changes** 💾
```bash
git add .
git commit -m "Add: Short description of your change"
```
6. **Push to Your Fork** 🚀
```bash
git push origin feature/your-feature-name
```
7. **Open a Pull Request** 📬
- Go to the original repo and open a **Pull Request** from your branch.