How writronic/macursor works
MaCursor is a macOS cursor customization app: users import or convert themes, edit them, and apply a theme to system cursors; the optional helper keeps behavior active in the background. Separate capabilities include per-app automation, menu-bar controls, capture and markup, translation, gestures, trails, focus-on-hover, and Finder context actions. The graph combines sampled calls and SOURCE INDEX references with README-documented capabilities; several feature implementations were not sampled, so their internal wiring is intentionally omitted.
Main entry points: MACCursorActions.swift Cursor Actions · HelperRuntime.swift Helper Runtime · CursorService.swift Cursor Service · MACCursorCapture.swift Cursor Capture
Components 25
Themes and Editing
- Theme Library
MaCursor/SwiftUI/Models/CursorLibrary.swift - Library Controller
MaCursor/SwiftUI/Services/LibraryController.swift - Theme Editor
MaCursor/SwiftUI/ViewModels/CursorThemeEditorViewModel.swift - Theme Conversion
MaCursor/SwiftUI/Services/ThemeConversion.swift - Windows Import
MaCursor/SwiftUI/Services/WindowsCursorImporter.swift - Image Import
MaCursor/SwiftUI/Services/SlotImageImporter.swift
Cursor Runtime
- Cursor Service
MaCursor/SwiftUI/Services/CursorService.swift - Cursor Actions
CursorEngine/MACCursorActions.swift - Cursor Definitions
CursorEngine/MACCursorDefinitions.swift - Preferences
MaCursor/SwiftUI/Models/MACPreferences.swift - Theme Automation
CursorEngine/MACAutoSwitch.swift
Background Helper
- Helper Manager
MaCursor/SwiftUI/Services/HelperToolManager.swift - Helper Runtime
CursorEngineHelper/HelperRuntime.swift - Menu Bar Controller
CursorEngineHelper/MenuBarController.swift - Menu Bar Panel
CursorEngineHelper/MenuBarPanelView.swift - Menu Bar Service
CursorEngineHelper/MenuBarService.swift
Cursor Features
- Cursor Capture
CursorEngine/MACCursorCapture.swift - Capture Editor
CursorEngineHelper/HelperScreenshotEditor.swift - Cursor Translator
CursorEngine/MACCursorTranslator.swift - Cursor Gestures
CursorEngine/MACCursorGestures.swift - Cursor Trails
CursorEngine/MACCursorTrails.swift - Focus on Hover
CursorEngine/MACFocusFollowsMouse.swift
Finder Actions
- Finder Extension
MaCursorFinder/MACFinderSync.swift - Finder Actions
MaCursorFinder/RightClickMenuActions.swift
Other components
- User
Connections 29
- User → Theme Library: imports themes
README.md - User → Theme Editor: edits themes
README.md - User → Theme Conversion: converts themes
README.md - Theme Conversion → Windows Import: imports Windows
- Theme Editor → Image Import: imports images
MaCursor/SwiftUI/ViewModels/CursorThemeEditorViewModel.swift - Theme Library → Library Controller: uses controller
MaCursor/SwiftUI/Models/CursorLibrary.swift - Library Controller → Cursor Service: applies theme
MaCursor/SwiftUI/Services/LibraryController.swift - Cursor Service → Cursor Actions: applies theme
MaCursor/SwiftUI/Services/CursorService.swift - Cursor Service → Cursor Definitions: validates identifiers
MaCursor/SwiftUI/Services/CursorService.swift - Cursor Actions → Cursor Definitions: uses definitions
CursorEngine/MACCursorActions.swift - User → Theme Automation: configures switching
README.md - Theme Automation → Cursor Actions: applies themes
- Preferences → Cursor Actions: configures behavior
CursorEngine/MACCursorActions.swift - User → Helper Manager: installs helper
README.md - Helper Manager → Helper Runtime: registers helper
MaCursor/SwiftUI/Services/HelperToolManager.swift - Helper Runtime → Cursor Actions: controls cursors
CursorEngineHelper/HelperRuntime.swift - Helper Runtime → Cursor Capture: dispatches capture
CursorEngineHelper/HelperRuntime.swift - Helper Runtime → Menu Bar Controller: controls panel
CursorEngineHelper/HelperRuntime.swift - Menu Bar Controller → Menu Bar Panel: hosts view
CursorEngineHelper/MenuBarController.swift - Menu Bar Panel → Menu Bar Service: uses service
CursorEngineHelper/MenuBarPanelView.swift - Menu Bar Service → Cursor Actions: controls cursors
CursorEngineHelper/MenuBarService.swift - User → Cursor Capture: captures screen
README.md - Cursor Capture → Capture Editor: opens editor
- User → Cursor Translator: translates screen text
README.md - User → Cursor Gestures: configures gestures
README.md - User → Cursor Trails: configures trails
README.md - User → Focus on Hover: enables hover focus
README.md - User → Finder Extension: uses Finder menu
README.md - Finder Extension → Finder Actions: dispatches actions
MaCursorFinder/MACFinderSync.swift