How thaqibrahman/ai-virtual-mouse works
This is a real-time, webcam-driven virtual mouse. The main loop captures and processes frames, passes hand landmarks into gesture interpretation, and maps recognized gestures to cursor, click, screenshot, and volume actions. README capabilities such as double-click and volume control are represented where documented and visible in the sampled runtime. The implementation is concentrated in main.py; util.py provides geometry helpers, but the shown code does not call them. Relationships reflect the shown code and README, not an assumed pipeline beyond it.
Main entry points: main.py Frame loop · util.py Geometry helpers
Components 14
Vision and gesture input
- Frame loop
AI Virtual Mouse/main.py - Hand tracking
AI Virtual Mouse/main.py - Gesture mapping
AI Virtual Mouse/main.py
System actions
- Cursor movement
AI Virtual Mouse/main.py - Click actions
AI Virtual Mouse/main.py - Screenshot capture
AI Virtual Mouse/main.py - Volume control
AI Virtual Mouse/main.py
Geometry helpers
- Geometry helpers
AI Virtual Mouse/util.py
Other components
- User hand gestures
- Webcam
- Desktop mouse
- Windows volume
- Screenshot file
- Video display
Connections 14
- User hand gestures → Webcam: gestures
README.md - Webcam → Frame loop: provides frames
AI Virtual Mouse/main.py - Frame loop → Hand tracking: processes frames
AI Virtual Mouse/main.py - Frame loop → Gesture mapping: passes landmarks
AI Virtual Mouse/main.py - Frame loop → Video display: shows video
AI Virtual Mouse/main.py - Gesture mapping → Cursor movement: moves cursor
AI Virtual Mouse/main.py - Cursor movement → Desktop mouse: moves pointer
AI Virtual Mouse/main.py - Gesture mapping → Click actions: triggers clicks
AI Virtual Mouse/main.py - Click actions → Desktop mouse: sends clicks
AI Virtual Mouse/main.py - Gesture mapping → Screenshot capture: captures image
AI Virtual Mouse/main.py - Screenshot capture → Screenshot file: saves image
AI Virtual Mouse/main.py - Gesture mapping → Volume control: adjusts volume
AI Virtual Mouse/main.py - Volume control → Windows volume: sends key events
AI Virtual Mouse/main.py - Frame loop → Geometry helpers: imports
AI Virtual Mouse/main.py