A Python-based virtual mouse that lets you control your computer cursor with hand gestures using your webcam. This project utilizes OpenCV for image processing, MediaPipe for real-time hand tracking, and PyAutoGUI to simulate mouse actions.
- 🖐️ Hand tracking with high accuracy using MediaPipe
- 🖱️ Cursor movement using index finger
- 👆 Left click with index + middle finger pinch
- 🤏 Right click with index + ring finger pinch
- 🔄 Extendable for scroll and drag gestures
- Python 3.8+
- OpenCV – for video capture and processing
- MediaPipe – for hand landmark detection
- PyAutoGUI – for mouse control
You can install all dependencies with:
pip install -r requirements.txtpip install opencv-python mediapipe pyautogui- Clone the Repository
git clone https://github.com/yourusername/virtual-mouse-opencv.git
cd virtual-mouse-opencv- Run the Script
python virtual_mouse.pyMake sure your webcam is connected and accessible.
-
The webcam feed is processed frame by frame using OpenCV.
-
MediaPipe detects and tracks 21 hand landmarks.
-
Coordinates of the index finger tip are used to move the cursor.
-
Distance between specific fingers determines click actions:
- Left Click: Pinch index and middle fingers
- Right Click: Pinch index and ring fingers
virtual-mouse/
│
├── virtual_mouse.py # Main Python script
├── README.md # Project readme
├── requirements.txt # Python package dependencies
└── screenshots/
Watch the original tutorial by Murtaza’s Workshop:
Built based on the tutorial by Murtaza’s Workshop - Robotics and AI.
This project is licensed under the MIT License. Feel free to use and modify for learning purposes.
If you have questions or improvements, feel free to raise an issue or contribute via pull request.