How kenny-fred/cursor works
Cursor is a local webcam-based eye-tracking application: users calibrate their gaze against screen targets, then use the personal mapping to control the Windows cursor. Its runtime combines feature extraction, calibration mapping, and grid-based stabilization; separate scripts validate the camera, prototype eye detection, and analyze calibration quality. The main application and its tracking path are only partially excerpted, so their documented relationships are cited to the README; the accuracy script’s dataset read is visible in its source.
Main entry points: main.py Cursor App · 3_calibration.py Target Capture · 5_calib_test.py Windows Cursor · 1_cam_test.py Camera Check
Components 13
Calibration
- Target Capture
3_calibration.py - Feature Extraction
3_calibration.py - Calibration Dataset
Cursor Runtime
- Cursor App
main.py - Gaze Mapping
main.py - Grid Stabilization
main.py - Windows Cursor
5_calib_test.py
Evaluation
- Dataset Analysis
4_accuracy.py
Hardware Prototypes
- Camera Check
1_cam_test.py - Eye Prototype
2_eye_test.py
Other components
- User
- Webcam
- MediaPipe
Connections 18
- User → Camera Check: tests camera
README.md - Webcam → Camera Check: provides frames
README.md - User → Eye Prototype: tests detection
README.md - Webcam → Eye Prototype: provides frames
README.md - User → Target Capture: looks at targets
README.md - Webcam → Target Capture: provides frames
README.md - Target Capture → Feature Extraction: collects measurements
README.md - MediaPipe → Feature Extraction: detects landmarks
README.md - Feature Extraction → Calibration Dataset: stores samples
README.md - Calibration Dataset → Dataset Analysis: loads dataset
4_accuracy.py - User → Cursor App: starts tracking
README.md - Webcam → Cursor App: provides frames
README.md - MediaPipe → Cursor App: extracts landmarks
README.md - Calibration Dataset → Gaze Mapping: fits personal model
README.md - Cursor App → Gaze Mapping: maps features
README.md - Gaze Mapping → Grid Stabilization: filters positions
README.md - Grid Stabilization → Windows Cursor: stabilizes movement
README.md - Windows Cursor → User: moves pointer
README.md