This project is a hand gesture-based mouse controller built using Python, OpenCV, and MediaPipe. It lets you control your computer's mouse using just your hand.
- ☝️ Move your mouse by moving your index finger
- 🖱️ Left click, Right click, and Double click detection via gestures
- ✋ Left and Right hand classification
- 🤲 Multi-hand support (several hands can be detected independently)
- 🎯 Visual cursor (a circle drawn on your fingertip)
- ⚡Smooth and real-time performance
- Python 3.10+
- OpenCV
- Mediapipe
- Numpy
- pyautogui
- Python 3.10+
- Webcam
- A decent CPU for real-time performance
- Make sure your camera has a good view of your hand.
- Good lighting improves hand detection accuracy.
- Only your thumb, index and middle finger gestures are important.
- Only one hand can be used as a controller. It's the right hand by default
- Clone or download the repository
git clone https://github.com/Alicia105/HandMouseController.git
- Navigate to the project directory
cd HandMouseController
- Install needed dependencies
pip install -r requirement.txt
- Navigate to the project source code directory
cd HandMouseController/src
- Launch the app
python main.py
-
To move the mouse you have to bend your thumb
-
To do any click you have to unfold your thumb. Bend your index to a left click
-
Bend your middle finger to do a right click
-
Bend your index and middle finger to do a double click
