How prithvisb08/neuromouse works
NeuroMouse has two runtimes: a native Swift macOS menu-bar/dashboard app and a Python reference prototype. Both turn webcam-based head motion into cursor control, with calibration, filtering, gesture input, and safety behavior; the README also describes headphone-triggered clicks and accessibility target gravity. The sampled Swift AppState excerpt and Python entry-point excerpt expose only parts of their processing loops, so unsampled subsystem connections are omitted rather than inferred.
Main entry points: AppState.swift App State · main.py Python Entry · cursor_controller.py Python Cursor · MovementEngine.swift Movement Engine
Components 29
App Runtime
- Swift App Entry
macos-app/Sources/HeadMotionMouseApp/HeadMotionMouseApp.swift - App State
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - Dashboard
macos-app/Sources/HeadMotionMouseCore/Dashboard/DashboardWindowView.swift - Settings Store
macos-app/Sources/HeadMotionMouseCore/Settings/SettingsStore.swift - Permissions
macos-app/Sources/HeadMotionMouseCore/Permissions/PermissionManager.swift - Python Entry
python-prototype/main.py
Camera Perception
- Camera Capture
macos-app/Sources/HeadMotionMouseCore/Camera/CameraManager.swift - Face Landmarks
macos-app/Sources/HeadMotionMouseCore/Vision/FaceLandmarkProcessor.swift - Craniofacial Pose
macos-app/Sources/HeadMotionMouseCore/PoseEstimation/CraniofacialPoseEstimator.swift - Headphone Tracker
macos-app/Sources/HeadMotionMouseCore/Vision/HeadphoneVisualTracker.swift - Python Camera
python-prototype/camera/camera_manager.py - Python Vision
python-prototype/vision/face_landmarks.py
Motion Processing
- Calibration
macos-app/Sources/HeadMotionMouseCore/Calibration/CalibrationManager.swift - Movement Engine
macos-app/Sources/HeadMotionMouseCore/MotionEngine/MovementEngine.swift - Dead Zone
macos-app/Sources/HeadMotionMouseCore/MotionEngine/DeadZoneProcessor.swift - 1€ Filter
macos-app/Sources/HeadMotionMouseCore/MotionEngine/OneEuroFilter.swift - Movement Mapper
python-prototype/motion/movement_mapper.py - Python Calibration
python-prototype/motion/calibration.py
Cursor Interaction
- Gesture Engine
macos-app/Sources/HeadMotionMouseCore/Gestures/GestureEngine.swift - Dwell Detector
macos-app/Sources/HeadMotionMouseCore/Gestures/DwellClickDetector.swift - Headphone Tap
macos-app/Sources/HeadMotionMouseCore/Gestures/HeadphoneTapDetector.swift - Headphone Monitor
macos-app/Sources/HeadMotionMouseCore/Hardware/HeadphoneConnectionMonitor.swift - Target Gravity
macos-app/Sources/HeadMotionMouseCore/Cursor/AccessibilityGravityEngine.swift - Cursor Controller
macos-app/Sources/HeadMotionMouseCore/Cursor/CursorController.swift - Gesture Manager
python-prototype/gestures/gesture_manager.py - Headphone Listener
python-prototype/gestures/headphone_listener.py - Python Cursor
python-prototype/cursor/cursor_controller.py - Scroll Controller
python-prototype/cursor/scroll_controller.py
Other components
- User
Connections 34
- User → Swift App Entry: launches
README.md - Swift App Entry → App State: creates
macos-app/Sources/HeadMotionMouseApp/HeadMotionMouseApp.swift - Swift App Entry → Dashboard: presents
macos-app/Sources/HeadMotionMouseApp/HeadMotionMouseApp.swift - App State → Settings Store: loads
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Permissions: checks
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Camera Capture: starts
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Face Landmarks: processes
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Headphone Tracker: uses
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Movement Engine: configures
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Calibration: calibrates
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Gesture Engine: updates
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Cursor Controller: commands
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Target Gravity: queries
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Headphone Tap: routes
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - App State → Headphone Monitor: monitors
macos-app/Sources/HeadMotionMouseCore/App/AppState.swift - Movement Engine → Dead Zone: filters
macos-app/Sources/HeadMotionMouseCore/MotionEngine/MovementEngine.swift - Movement Engine → 1€ Filter: smooths
macos-app/Sources/HeadMotionMouseCore/MotionEngine/MovementEngine.swift - Gesture Engine → Dwell Detector: updates
macos-app/Sources/HeadMotionMouseCore/Gestures/GestureEngine.swift - Target Gravity → Movement Engine: damps
- Gesture Engine → Cursor Controller: clicks
- Headphone Tap → Cursor Controller: triggers clicks
- Headphone Monitor → Headphone Tap: detects input
- User → Python Entry: launches
README.md - Python Entry → Python Camera: captures
python-prototype/main.py - Python Entry → Movement Mapper: initializes
python-prototype/main.py - Python Entry → Python Calibration: initializes
python-prototype/main.py - Python Entry → Python Cursor: initializes
python-prototype/main.py - Python Vision → Craniofacial Pose: estimates pose
python-prototype/vision/face_landmarks.py - Python Entry → Python Vision: processes frames
- Python Entry → Gesture Manager: updates
- Gesture Manager → Python Cursor: routes clicks
python-prototype/gestures/gesture_manager.py - Headphone Listener → Python Cursor: triggers clicks
- Scroll Controller → Python Cursor: dispatches scroll
python-prototype/cursor/scroll_controller.py - Movement Mapper → Python Cursor: sets position