Skip to content

README.md

Latest commit

 

History

History
47 lines (35 loc) · 1.23 KB

README.md

File metadata and controls

47 lines (35 loc) · 1.23 KB

Finger Virtual Mouse

Control your mouse using hand gestures captured by your webcam. This application uses MediaPipe for hand tracking and supports both X11 and Wayland (including Hyprland).

Features

  • X11 and Wayland (Hyprland) support
  • GPU acceleration where available
  • Smooth mouse movement with exponential smoothing
  • Multiple gestures for different mouse actions:
    • INDEX FINGER + THUMB = LEFT CLICK
    • MIDDLE FINGER + THUMB = RIGHT CLICK
    • RING FINGER + THUMB = DOUBLE CLICK
    • PINKY + THUMB = SCROLL MODE
  • Real-time FPS display to monitor performance

Requirements

  • Python 3.6+
  • OpenCV
  • MediaPipe
  • PyAutoGUI (for X11) or pynput/ydotool (for Wayland)
  • NumPy

Installation

  1. Clone the repository
git clone https://github.com/a3ro-dev/finger_virtual_mouse
  1. Install the required packages
pip install -r requirements.txt
  1. Run the program
python mouse.py

Contributing

Any contributions are appreciated. Feel free to submit a pull request or open an issue if you have any suggestions or find any bugs.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details