Skip to content

"A suite of standalone Python utilities for gesture-based Human-Computer Interaction (HCI). Leverages MediaPipe and OpenCV to control Windows system functions (mouse, volume, brightness, zoom) via real-time hand landmark tracking and Kalman-filtered state estimation."

Notifications You must be signed in to change notification settings

SamXavii902/Touchless-Interface-HCI

Repository files navigation

🖐️ Touchless OS: Gesture-Based Human-Computer Interaction

Python Computer Vision MediaPipe UI

📖 Overview

Touchless OS is a suite of standalone Python utilities that allow for zero-touch control of your Windows environment using advanced Computer Vision. By leveraging MediaPipe's Hand Landmark Model and PyAutoGUI, this project translates real-time hand gestures into system commands like cursor movement, scrolling, zooming, and volume adjustment.

🚀 Individual Modules & Gestures

Each script is designed to run independently. Simply launch the script and use the corresponding gestures:

1. 🖱️ Virtual Mouse (VirtualMouse.py)

  • Movement: Point with your index finger to move the cursor.
  • Left Click: Raise your pinky while keeping other fingers in a fist.
  • Right Click: Raise your index while keeping other fingers in a fist.

2. 📜 Scroll & Zoom Control (ScrollControl.py / ZoomControl.py)

  • Scrolling: Pinch your index and thumb together and move your wrist vertically to scroll.
  • Zoom In: Pinch both hands and move them away from each other.
  • Zoom Out: Pinch both hands and move them toward each other.

3. 🎨 Air Canvas (AirCanvas.py)

  • Drawing: Pinch index and middle fingers to "write" in the air.
  • Smoothing: Utilizes a custom Kalman Filter to eliminate hand jitters for smooth digital ink.

4. 🔉 System Controls (VolumeTesting.py & BrightnessSlider.py)

  • Volume/Brightness: A virtual slider appears on screen. Pinch and drag the yellow knob to adjust levels.

5. 📸 Screenshot (Screenshot.py)

  • Capture: Form two tight fists simultaneously to save a screenshot with a timestamp.

🛠️ Installation & Setup

  1. Clone the Repository
    git clone [https://github.com/SamXavii902/Touchless-Interface-HCI.git](https://github.com/SamXavii902/Touchless-Interface-HCI.git)
    cd Touchless-Interface-HCI

Install Dependencies

Bash

pip install -r requirements.txt Run a Script

Bash

python VirtualMouse.py

🧠 Technical Highlights

Kalman Smoothing: Implemented state estimation to filter raw landmark data, providing a jitter-free user experience.

State Machines: Each module manages its own cooldowns and gesture confirmation frames to prevent accidental triggers.

Windows Integration: Leverages PowerShell and PyCaw for deep system-level hardware control.

About

"A suite of standalone Python utilities for gesture-based Human-Computer Interaction (HCI). Leverages MediaPipe and OpenCV to control Windows system functions (mouse, volume, brightness, zoom) via real-time hand landmark tracking and Kalman-filtered state estimation."

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages