How dream-rainy/cursorhide works
CursorHide is a Windows .NET tray application that hides the system pointer after qualifying keyboard input and restores it after pointer movement or other recovery events. Its main workflow runs from input monitoring through context and input classification, state coordination, and native cursor presentation; settings, exclusions, tooltip protection, and crash recovery extend that workflow. The README documents these capabilities, while some implementation details are unsampled, so uncertain links are omitted.
Main entry points: CursorCoordinator.cs Cursor coordinator · SystemCursorController.cs System cursor control · TrayApplicationContext.cs Tray application · Program.cs Application startup
Components 27
Runtime and input
- Application startup
src/CursorHide/Program.cs - Input monitor
src/CursorHide/Hooks/LowLevelInputMonitor.cs - Session monitor
src/CursorHide/Services/SessionChangeMonitor.cs - Cursor coordinator
src/CursorHide/Core/CursorCoordinator.cs
Input and context
- Input classifier
src/CursorHide/Core/InputClassifier.cs - Cursor state machine
src/CursorHide/Core/CursorStateMachine.cs - Foreground context
src/CursorHide/Context/ForegroundContextProvider.cs - Exclusion policy
src/CursorHide/Context/ExclusionPolicy.cs
Cursor and recovery
- System cursor control
src/CursorHide/Recovery/SystemCursorController.cs - Cursor image factory
src/CursorHide/Recovery/SystemCursorImageFactory.cs - Cursor scheme catalog
src/CursorHide/Recovery/CursorSchemeCatalog.cs - Recovery executor
src/CursorHide/Recovery/CursorRecoveryExecutor.cs - System cursor roles
src/CursorHide/Recovery/SystemCursorRoles.cs - Recovery markers
src/CursorHide/Recovery/RecoveryMarkerStore.cs - Recovery watchdog
src/CursorHide/Recovery/WatchdogManager.cs
Tooltip protection
- Tooltip monitor
src/CursorHide/Tooltips/TooltipMonitor.cs - UI Automation inspector
src/CursorHide/Tooltips/AutomationTooltipInspector.cs - Passive tooltip classifier
src/CursorHide/Tooltips/PassiveTooltipClassifier.cs
Settings and tray
- Tray application
src/CursorHide/UI/TrayApplicationContext.cs - Settings form
src/CursorHide/UI/SettingsForm.cs - Settings store
src/CursorHide/Services/SettingsStore.cs - Global hotkey
src/CursorHide/Services/GlobalHotkeyManager.cs - Startup registration
src/CursorHide/Services/StartupManager.cs
Other components
- User
- Keyboard input
- Mouse movement
- Windows APIs
Connections 35
- User → Keyboard input: types
- User → Mouse movement: moves pointer
- Keyboard input → Input monitor: emits events
- Mouse movement → Input monitor: emits events
- Application startup → Input monitor: starts
src/CursorHide/Program.cs - Application startup → Cursor coordinator: creates
src/CursorHide/Program.cs - Application startup → Tooltip monitor: starts
src/CursorHide/Program.cs - Application startup → Session monitor: starts
src/CursorHide/Program.cs - Application startup → Tray application: runs
src/CursorHide/Program.cs - Input monitor → Cursor coordinator: posts events
src/CursorHide/Program.cs - Tooltip monitor → Cursor coordinator: posts events
src/CursorHide/Program.cs - Session monitor → Cursor coordinator: posts events
src/CursorHide/Program.cs - Cursor coordinator → Input classifier: classifies input
src/CursorHide/Core/CursorCoordinator.cs - Cursor coordinator → Cursor state machine: updates state
src/CursorHide/Core/CursorCoordinator.cs - Cursor coordinator → Foreground context: captures context
- Foreground context → Exclusion policy: checks exclusions
src/CursorHide/Context/ForegroundContextProvider.cs - Cursor coordinator → System cursor control: controls presentation
- Cursor coordinator → Tooltip monitor: tracks candidates
src/CursorHide/Core/CursorCoordinator.cs - Tooltip monitor → UI Automation inspector: inspects elements
src/CursorHide/Tooltips/TooltipMonitor.cs - Tooltip monitor → Passive tooltip classifier: classifies candidates
src/CursorHide/Tooltips/TooltipMonitor.cs - System cursor control → Cursor image factory: creates cursor image
src/CursorHide/Recovery/SystemCursorController.cs - System cursor control → Cursor scheme catalog: snapshots scheme
src/CursorHide/Recovery/SystemCursorController.cs - System cursor control → Recovery executor: restores scheme
src/CursorHide/Recovery/SystemCursorController.cs - Recovery executor → System cursor roles: uses roles
src/CursorHide/Recovery/CursorRecoveryExecutor.cs - System cursor control → Recovery markers: writes recovery marker
- System cursor control → Recovery watchdog: ensures watchdog
- System cursor control → Windows APIs: installs system cursor
src/CursorHide/Recovery/SystemCursorController.cs - User → Tray application: operates
- Tray application → Cursor coordinator: posts commands
src/CursorHide/UI/TrayApplicationContext.cs - Tray application → Settings form: opens
src/CursorHide/UI/TrayApplicationContext.cs - Tray application → Settings store: saves settings
src/CursorHide/UI/TrayApplicationContext.cs - Tray application → Global hotkey: registers shortcut
src/CursorHide/UI/TrayApplicationContext.cs - Tray application → Startup registration: sets startup
src/CursorHide/UI/TrayApplicationContext.cs - Application startup → Settings store: loads settings
src/CursorHide/Program.cs - Settings form → Cursor scheme catalog: lists schemes
src/CursorHide/UI/SettingsForm.cs