Skip to content

The-Shreyas-M/aircontrol-elite

Repository files navigation

🚀 AirControl Elite: Hybrid Gesture Interface

AirControl Elite is a high-performance, touchless interface system. It combines Hand Tracking for complex input and Face Mesh for hands-free navigation, allowing full computer control without a physical mouse or keyboard.

🛠 Quick Start

  1. Connect your webcam.
  2. Run Run_AirControl.bat from your desktop.
  3. Choose your mode in the launcher.

🖐 Mode 1: Hand Gestures (handsmain.py)

Optimized for typing and precise clicking.

Keyboard Mode

  • Alphabet Dial: Rotate your Right Hand (index finger up) to cycle through A-Z.
  • Symbols/Digits: Make a Fist with your Right Hand to switch the dial to numbers and symbols.
  • Type Character: Pinch Left Index + Thumb.
  • Space: Pinch Left Middle + Thumb.
  • Backspace: Pinch Left Pinky + Thumb.
  • Enter: Show Right Palm to the camera.

Mouse Mode

  • Toggle Mode: Hold Left Fist for 1.2 seconds.
  • Move Cursor: Bring Right Index & Middle together (Scissors) and move.
  • Left Click: Pinch Right Index + Thumb.
  • Right Click: Pinch Right Middle + Thumb.

🎭 Mode 2: Face Gestures (facemain.py)

Optimized for effortless navigation and "clutched" movement.

The Controls

  • Nose Drive: Move your Nose to drive the cursor relative to your head position.
  • The Clutch (Park): Open your mouth to freeze the cursor. This allows you to look around or rest your neck.
  • Clicks: * Left Click: Close Left Eye (1.2s).
    • Right Click: Close Right Eye (1.2s).
    • Double Click: Close Both Eyes (0.8s).

The Security Gate (10s Timeout)

If your mouth remains open for 10 seconds, the system enters a safety prompt:

  • Blink Left: Exit App.
  • Blink Right: Resume Operation.

📸 Visual Guide

System Interface

The Master Launcher Launcher Menu

Keyboard: Alphabet Dial Alphabet Dial

Keyboard: Digits & Symbols Digits and Symbols

Hand Mouse Mode Hand Mouse Mode

Pause State Pause Operation


Face Navigation

Nose Drive (Moving) Face Mouse Moving

The Clutch (Mouth Open / Parked) Face Mouse Clutched


Safety & Exit

The 10-Second Timeout Choice System Exit Choice

Exit Confirmation Exit Dialogue

About

AirControl Elite is a high-performance, touchless interface system. It combines Hand Tracking for complex input and Face Mesh for hands-free navigation, allowing full computer control without a physical mouse or keyboard.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors