Skip to content

Reene444/air-mouse-control

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 

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

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages