How shashvat1965/slidesense works
SlideSense is a macOS menu-bar app that turns trackpad-edge gestures into system-level changes. The main workflow is touch frames → gesture interpretation → level/media actions → HUD and menu feedback. Settings control edge mapping, gesture behavior, appearance, startup, and updates. The coordinator is the internal layer connecting input, controllers, and UI. The README documents the major capabilities; some connections to unsampled implementation details are omitted rather than inferred.
Main entry points: AppCoordinator.swift App Coordinator · SettingsView.swift Settings View · TrackpadMonitor.swift Trackpad Monitor · SlideEngine.swift Gesture Engine
Components 25
Touch and Gestures
- Trackpad Monitor
Sources/SlideSenseCore/Multitouch/TrackpadMonitor.swift - Touch Frames
Sources/SlideSenseCore/Multitouch/TouchInput.swift - Gesture Engine
Sources/SlideSenseCore/Model/SlideEngine.swift - Edge Geometry
Sources/SlideSenseCore/Model/EdgeGeometry.swift
System Controls
- Audio Controller
Sources/SlideSenseCore/System/AudioController.swift - Brightness Controller
Sources/SlideSenseCore/System/BrightnessController.swift - Media Key Controller
Sources/SlideSenseCore/System/MediaKeyController.swift - Level Protocol
Sources/SlideSenseCore/System/LevelController.swift - Haptics
Sources/SlideSenseCore/System/Haptics.swift - Cursor Freeze
Sources/SlideSenseCore/System/CursorFreezer.swift
App Interface
- App Coordinator
Sources/SlideSenseCore/AppCoordinator.swift - HUD Controller
Sources/SlideSenseCore/UI/HUDController.swift - HUD View
Sources/SlideSenseCore/UI/HUDView.swift - Menu Bar
Sources/SlideSenseCore/UI/StatusItemController.swift - Settings Window
Sources/SlideSenseCore/UI/SettingsWindowController.swift - Settings View
Sources/SlideSenseCore/UI/SettingsView.swift - App Delegate
Sources/SlideSenseCore/AppDelegate.swift - App Entry
Sources/SlideSense/main.swift
Settings and Lifecycle
- Settings Store
Sources/SlideSenseCore/Model/Settings.swift - Accessibility Permission
Sources/SlideSenseCore/System/AccessibilityPermission.swift - Login Item
Sources/SlideSenseCore/System/LoginItem.swift - Update Controller
Sources/SlideSenseCore/System/UpdateController.swift
Other components
- Trackpad User
- macOS Services
- GitHub Releases
Connections 29
- Trackpad User → Trackpad Monitor: makes gestures
README.md - Trackpad Monitor → Touch Frames: emits frames
README.md - Touch Frames → Gesture Engine: interpreted by
README.md - Gesture Engine → Edge Geometry: uses geometry
Sources/SlideSenseCore/Model/SlideEngine.swift - App Coordinator → Trackpad Monitor: starts monitoring
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Gesture Engine: configures gestures
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Audio Controller: controls volume
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Brightness Controller: controls brightness
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Media Key Controller: dispatches media
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Haptics: triggers feedback
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Cursor Freeze: freezes pointer
Sources/SlideSenseCore/AppCoordinator.swift - Audio Controller → macOS Services: reads and writes volume
README.md - Brightness Controller → macOS Services: sets brightness
README.md - Media Key Controller → macOS Services: posts key events
Sources/SlideSenseCore/System/MediaKeyController.swift - App Coordinator → HUD Controller: presents feedback
Sources/SlideSenseCore/AppCoordinator.swift - HUD Controller → HUD View: configures view
Sources/SlideSenseCore/UI/HUDController.swift - App Coordinator → Menu Bar: provides readouts
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Settings Window: opens settings
Sources/SlideSenseCore/AppCoordinator.swift - Settings Window → Settings View: hosts view
Sources/SlideSenseCore/UI/SettingsWindowController.swift - Settings View → Settings Store: edits settings
Sources/SlideSenseCore/UI/SettingsView.swift - Menu Bar → Settings Store: reads enabled state
Sources/SlideSenseCore/UI/StatusItemController.swift - Settings View → Accessibility Permission: shows permission
Sources/SlideSenseCore/UI/SettingsView.swift - Settings View → Login Item: configures startup
Sources/SlideSenseCore/UI/SettingsView.swift - App Coordinator → Accessibility Permission: checks access
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Login Item: manages startup
Sources/SlideSenseCore/AppCoordinator.swift - App Coordinator → Update Controller: checks releases
Sources/SlideSenseCore/AppCoordinator.swift - Update Controller → GitHub Releases: fetches updates
README.md - App Entry → App Delegate: starts app
Sources/SlideSense/main.swift - App Delegate → App Coordinator: creates coordinator
Sources/SlideSenseCore/AppDelegate.swift