https://github.com/sushmithaa02/virtual-mouse-keyboard

Control your PC with Hand Gestures! A futuristic AI-powered Virtual Mouse & Keyboard built using Python, OpenCV, and MediaPipe. Touchless interaction made seamless.
https://github.com/sushmithaa02/virtual-mouse-keyboard

computer-vision gesture-recognition hand-tracking-automation mediapipe opencv python virtual-keyboard virtual-mouse

Last synced: about 1 month ago
JSON representation

Control your PC with Hand Gestures! A futuristic AI-powered Virtual Mouse & Keyboard built using Python, OpenCV, and MediaPipe. Touchless interaction made seamless.

• Host: GitHub
• URL: https://github.com/sushmithaa02/virtual-mouse-keyboard
• Owner: sushmithaa02
• License: other
• Created: 2025-12-14T03:34:18.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-12-14T03:55:55.000Z (6 months ago)
• Last Synced: 2025-12-16T03:52:45.499Z (6 months ago)
• Topics: computer-vision, gesture-recognition, hand-tracking-automation, mediapipe, opencv, python, virtual-keyboard, virtual-mouse
• Language: Python
• Homepage:
• Size: 28.3 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# virtual-mouse-keyboard

This project allows you to control your computer's mouse and a virtual keyboard using hand gestures detected through your webcam. It is built with Python using OpenCV, MediaPipe, and PyAutoGUI.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

![Python](https://img.shields.io/badge/Python-3.7%2B-blue)

![Platform](https://img.shields.io/badge/Platform-Windows%7CLinux-lightgrey)

![OpenCV](https://img.shields.io/badge/OpenCV-4.5%2B-brightgreen)

---

## Features ✨

* 🧠 **Mode Switching**: Seamlessly switch between Mouse, Keyboard, and Neutral modes with a fist gesture.

* 🎯 **Smoothed Mouse Control**: Jitter-free cursor movement that follows your index finger.

* 🤏 **Gesture-Based Clicks**: Perform a left-click by pinching your index finger and thumb.

* ⌨️ **Virtual Keyboard**: Type on a screen-rendered keyboard using a dwell-to-type mechanism.

---

## ⚙️ Setup and Installation

1.  **Clone the repository or create the file structure:**

    Ensure you have the files `main.py`, `utils.py`, `gestures.md`, and `README.md` in a folder named `virtual-mouse-keyboard`.

2.  **Install dependencies:**

    Open your terminal and run the following command to install the required Python libraries.

    ```bash

    pip install opencv-python mediapipe pyautogui numpy

    ```

---

## ▶️ How to Run

Navigate to the project directory in your terminal and run the main script:

```bash

cd path/to/virtual-mouse-keyboard

python main.py

```

📸 A window will open showing your webcam feed. 

Press 'q' to quit the application at any time. 

👉 Refer to `gestures.md` for a full guide on how to control the application.