AirControl 🖐️

A gesture-based computer control system using hand tracking. Control your Windows PC with hand gestures captured through your webcam.

📖 About

AirControl is a C++ application developed for computer control using hand gestures. It uses MediaPipe for real-time hand landmark detection and OpenCV for video capture, allowing users to control system functions through intuitive hand gestures.

✋ Supported Gestures

| Gesture | Action | |---------|--------| | Pinkie out only | Volume Up | | Thumb out only | Volume Down | | Thumb + Index finger | Play/Pause Media | | Index + Middle finger | Scroll Down | | Index + Middle + Ring finger | Scroll Up | | Both hands - Index fingers only | Switch Windows (Alt+Tab) |

🛠️ Prerequisites

• Windows OS
• Webcam
• MediaPipe C Library (libmediapipe) with C++ bindings
• OpenCV (4.7.5 was used for this project)
• Visual Studio 2022 with C++14 support

⚙️ Setup

1. Clone the repository:
2. Install MediaPipe and OpenCV dependencies.
3. Update the resource path in AirControl.cpp
4. Open AirControl.vcxproj in Visual Studio 2022.
5. Build and run the project.

🚀 Usage

1. Run the application.
2. Position your hand(s) in front of the webcam.
3. Perform gestures to control your system.
4. Press q to quit the application.

🔧 How It Works

• Uses MediaPipe's hand landmark tracking to detect 21 key points on each hand
• Calculates finger extension by comparingdirect distance vs. bone segment lengths
• Implements gesture stabilization using consecutive frame validation to reduce false positives
• Sends Windows keyboard/mouse events based on detected gestures

Default resource locations

OpenCV: C:
Mediapipe lib, bin and include: C:\mediapipe
Mediapipe data: C:\mediapipe\