STABLE NOW.

• Stable
• Works with both hands now

HandTracker

HandTracker is a webcam hand-tracking tool that turns finger curls into keyboard inputs.

It uses OpenCV and MediaPipe to detect one hand in real time. When you curl a finger, the app presses a matching keyboard key. When you open the finger again, the key is released.

The thumb detection also checks for a closed fist, so the thumb should count as pressed when it is tucked across the palm.

Keybinds

Finger	Key
Thumb	D
Index	F
Middle	G
Ring	H
Pinky	J

How to Use the EXE

1. Download HandTracker.exe from the release or dist folder.
2. Run HandTracker.exe.
3. Enter your camera index.
   • Most webcams use 0.
   • If 0 does not work, try 1 or 2.
4. Choose which hand should control the keys.
   • Type left, right, or both.
   • Press Enter to use the default: both.
5. Curl your fingers to press the matching keys.
6. Press Q in the camera window to quit.

The .exe version is standalone. You do not need to install Python or any Python libraries.

HandTracker

HandTracker

HandTracker is a webcam hand-tracking tool that turns finger curls into keyboard inputs.

It uses OpenCV and MediaPipe to detect one hand in real time. When you curl a finger, the app presses a matching keyboard key. When you open the finger again, the key is released.

Keybinds

Finger	Key
Thumb	D
Index	F
Middle	G
Ring	H
Pinky	J

How to Use the EXE

1. Download HandTracker.exe from the release or dist folder.
2. Run HandTracker.exe.
3. Enter your camera index.
   • Most webcams use 0.
   • If 0 does not work, try 1 or 2.
4. Curl your fingers to press the matching keys.
5. Press Q in the camera window to quit.

The .exe version is standalone. You do not need to install Python or any Python libraries.

How to Run From Source

Install Python, then install the required packages:

pip install opencv-python mediapipe keyboard

Make sure hand_landmarker.task is in the same folder as Handspython.py.

Then run:

python Handspython.py

Debug Window

The camera window shows finger status:

Color	Meaning
Green	Finger is open
Red	Finger is curled and the key is pressed

Notes

• A webcam is required.
• On some systems, keyboard input may work better if the app is run as administrator.
• Windows SmartScreen or antivirus may warn because the .exe is unsigned.
• If the camera does not open, try a different camera index.

License and Credit

This project uses the HandTracker Attribution License.

If you post a video, stream, tutorial, showcase, review, or other public media featuring this project, you must clearly credit:

Created by mrproiss1
GitHub: https://github.com/mrproiss1