Skip to content

About

AI-powered hand gesture mouse control. Control mac cursor, click, drag, and scroll with intuitive hand gestures. Works on macOS for accessibility and touchless control

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

🖐️ Enhanced Gesture Mouse Control

License Python OpenCV

🚀 Enhanced Gesture Mouse Control is a hand gesture-based mouse control tool powered by MediaPipe and OpenCV. It supports gesture locking, pinching for clicks, dragging, and scrolling operations.


🎯 Features

✅ Gesture-based Mouse Control - Move the cursor using your index finger with smooth motion and edge acceleration.

✅ Position Locking - Slightly bending your index or middle finger (>10°) locks the mouse position.

✅ Click & Drag - Pinching your thumb and index finger triggers a mouse click, while holding the pinch allows dragging.

✅ Scrolling Control - Quickly flicking your middle finger up and down enables page scrolling.

✅ Optimized Smoothing Algorithm - Uses a moving average filter for stable and responsive movement.

✅ Edge Acceleration - Enhances cursor movement speed near screen edges for efficient navigation.

✅ Cross-Platform Compatibility - Works on Windows, Linux, and macOS.


🛠️ Installation

Ensure you have Python 3.7 or later installed.

pip install opencv-python mediapipe pyautogui numpy

🚀 Run the Program

Run the following command in your terminal:

python mouse_control.py

Gesture Controls

Gesture Action Description
☝️ Index Finger Move Cursor The index finger controls mouse movement
✊ Finger Bend Lock Position Slightly bending the index or middle finger (>10°)
🤏 Pinch Click Bringing the thumb and index finger close together (<0.03) triggers a mouse click
✋ Hold Pinch Drag Holding the pinch allows dragging of windows or files
🖖 Flick Middle Finger Scroll Quickly moving the middle finger up and down scrolls the page

🤝 Contributing

We welcome contributions! Follow these steps to contribute:

  1. Fork this repository.
  2. Create a branch (git checkout -b feature-xyz).
  3. Commit your changes (git commit -m 'Added XYZ feature').
  4. Push to the branch (git push origin feature-xyz).
  5. Open a Pull Request!

📜 License

This project is licensed under the MIT License, allowing free use and modifications.

About

AI-powered hand gesture mouse control. Control mac cursor, click, drag, and scroll with intuitive hand gestures. Works on macOS for accessibility and touchless control

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages