Skip to content

Control your mouse with your hand

License

Notifications You must be signed in to change notification settings

Hawk3388/hand-tracking

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fc1db8d · · Sep 30, 2025

History

62 Commits
Sep 29, 2025
Sep 30, 2025
Sep 29, 2025
Feb 17, 2025
Sep 29, 2025
Sep 29, 2025

Repository files navigation

Hand Tracking 🖐️

Control your computer with just your hands.

Features

  • Hand gesture recognition for mouse control
  • Two modes: GUI window or background operation
  • ASL recognition model (American Sign Language) support
  • Multi-monitor support
  • Standalone executables - no Python installation required

System Requirements

  • Windows 10/11
  • Webcam
  • For Python users: Python 3.8-3.11

Quick Start

Option 1: Pre-built Executables (Recommended)

  1. Download the .exe file from the latest release on GitHub Releases
  2. Run hand-tracking.exe for GUI mode or hand-tracking-no-window.exe for background mode

Option 2: Run with Python

git clone https://github.com/Hawk3388/hand-tracking.git

cd hand-tracking
pip install -r requirements.txt
python src/hand-tracking.py            # GUI mode
python src/hand-tracking-no-window.py  # Background mode

Option 3: Build Your Own Executables

pip install pyinstaller==6.12.0
python src/build_exe.pyy

This creates two executables in the dist/ folder.

Usage

  • Mouse Control: Move your hand to control the cursor
  • Click: Make a fist to click
  • Mode Switch: Thumb + Middle finger to toggle between mouse and ASL modes
  • Multi-monitor: Move hand to screen edges to switch monitors

Controls

  • Mouse Mode: Hand movements control cursor, fist = click
  • ASL Mode: Recognizes American Sign Language gestures
  • Exit: Press 'q' in GUI mode or Ctrl+C in console mode

Credits

Special thanks to:

License

MIT License - see LICENSE file

About

Control your mouse with your hand

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages