Skip to content

Snapix/TouchlessTouch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 

Repository files navigation

✨ TouchlessTouch β€” Alpha

TouchlessTouch turns a regular webcam into a touch-free, precision input system.
Control your cursor, clicks, and drag actions using hand movements β€” no mouse, no touch, just vision.


🌐 Official Website

πŸ‘‰ https://touchlesstouch.vercel.app
Primary site β€” latest updates & best experience


πŸ–οΈ What is TouchlessTouch?

TouchlessTouch transforms a standard camera into a high-accuracy air-input device using computer vision.
By tracking green finger markers and mapping real-world movement to your display, it enables smooth cursor control with reliable click and drag detection β€” all without physical contact.

Built for experimentation, accessibility, and next-gen human–computer interaction.


πŸ› οΈ How It Works

🎯 Vision Engine (HSV Filtering)

  • Tracks green finger rings using HSV color space
  • Noise filtering removes small artifacts and false positives
  • Optimized for real-time performance

πŸ“ Perspective Mapping

  • 4-point calibration defines a virtual β€œair workspace”
  • Homography mapping converts camera space β†’ screen space
  • Works across resolutions, DPI scaling, and 4K displays

🧠 Dual-Point Interaction Logic

  • Navigator (Master Ring)
    • Inside calibrated area β†’ controls cursor movement
  • Trigger (Click Ring)
    • Brief exit β†’ click
    • Long exit β†’ click & hold (drag / draw)
  • Designed to avoid cursor jumps and accidental clicks

πŸŽ›οΈ Controls & UI

Control Action
Refresh Devices Detect available cameras
Start Engine Launch tracking & processing loop
Calibrate Select 4 points to define workspace
Mirror Camera Flip camera feed horizontally
Smoothing Enable cursor interpolation
Reset All Stop engine & clear calibration

πŸ“· Hardware & Usage Recommendations

  • External HD webcam (1080p) recommended
  • Laptop webcams are not ideal for calibrated setups
  • Disable HDR and image enhancements on professional cameras
  • Green finger rings required on both hands
  • Optional: Use as an β€œair mouse” directly in front of a display

⚑ Tips for Best Experience

  • Place the camera facing the screen you want to control
  • Use even, bright lighting
  • Close other apps using the camera
  • Ensure finger markers are visible before calibration

πŸš€ Alpha Release Notes

  • Reduced cursor lag and improved responsiveness
  • Fixed memory leaks in the tracking loop
  • Stabilized Dual-Point click and drag logic
  • General cleanup and performance optimizations

πŸ“₯ Download

Get the latest build from the
πŸ‘‰ GitHub Releases section of this repository


πŸ“œ License

Free for personal, non-commercial use.
See LICENSE.txt for full terms.

About

TouchlessTouch is an experimental touch-free input system that lets you control your computer using a camera and a simple green finger marker.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors