How yosaiy/renotch works
Re:notch is a native macOS command center hosted in the screen notch. The user-facing flow starts with the app creating its shared model and notch window, then the model coordinates notch modes and feature services; SwiftUI surfaces those features through compact, expanded, and settings views. Major capability branches include local developer-activity monitoring, media control, Pomodoro and website blocking, browser activity, calendar, and personal shelf/todo tools. Edges follow sampled calls or source-index references; browser-extension integration is documented in the README, while its exact runtime wiring is not shown.
Main entry points: AppModel.swift App model · RenotchApp.swift App bootstrap · NotchWindowController.swift Notch window · NotchView.swift Notch view
Components 23
App and Window Shell
- App bootstrap
Sources/Renotch/App/RenotchApp.swift - App model
Sources/Renotch/State/AppModel.swift - Notch window
Sources/Renotch/Window/NotchWindowController.swift - Screen manager
Sources/Renotch/Window/ScreenManager.swift
Notch Interface
- Notch view
Sources/Renotch/UI/NotchView.swift - Expanded notch
Sources/Renotch/UI/ExpandedNotchView.swift - Settings
Sources/Renotch/UI/SettingsView.swift
Developer and Media
- Developer activity
Sources/Renotch/Services/DeveloperActivityService.swift - Activity glance
Sources/Renotch/Models/DeveloperActivityGlance.swift - Music control
Sources/Renotch/Services/MusicService.swift
Focus and Planning
- Apple Calendar
Sources/Renotch/Services/AppleCalendarService.swift - Pomodoro timer
Sources/Renotch/Services/TimerService.swift - Website blocker
Sources/Renotch/Services/FocusBlockerService.swift - Blocker overlay
Sources/Renotch/Window/FocusBlockerOverlayController.swift - Notifications
Sources/Renotch/Services/NotificationService.swift - File shelf
Sources/Renotch/Services/ShelfStore.swift - Todo store
Sources/Renotch/Services/TodoStore.swift
Local Integrations
- Browser activity
Sources/Renotch/Services/BrowserActivityService.swift - Extension installer
Sources/Renotch/Services/BrowserIntegrationInstaller.swift - Browser extension
BrowserExtension/background.js - YouTube content script
BrowserExtension/youtube.js - Browser bridge
BrowserBridge/main.swift
Other components
- Mac user
Connections 26
- Mac user → App bootstrap: launches
Sources/Renotch/App/RenotchApp.swift - App bootstrap → App model: creates
Sources/Renotch/App/RenotchApp.swift - App bootstrap → Screen manager: creates
Sources/Renotch/App/RenotchApp.swift - App bootstrap → Notch window: creates
Sources/Renotch/App/RenotchApp.swift - Notch window → App model: reads state
Sources/Renotch/Window/NotchWindowController.swift - Notch window → Screen manager: selects display
Sources/Renotch/Window/NotchWindowController.swift - Notch window → Notch view: hosts
Sources/Renotch/Window/NotchWindowController.swift - Notch view → App model: drives modes
Sources/Renotch/UI/NotchView.swift - Notch view → Expanded notch: shows
Sources/Renotch/UI/NotchView.swift - App bootstrap → Settings: opens
- App model → Developer activity: refreshes
Sources/Renotch/State/AppModel.swift - Developer activity → Activity glance: builds activity
Sources/Renotch/Services/DeveloperActivityService.swift - App model → Music control: coordinates
Sources/Renotch/State/AppModel.swift - App model → Apple Calendar: coordinates
Sources/Renotch/State/AppModel.swift - App model → Pomodoro timer: coordinates
Sources/Renotch/State/AppModel.swift - App model → Website blocker: starts
Sources/Renotch/State/AppModel.swift - Website blocker → App model: triggers takeover
Sources/Renotch/Services/FocusBlockerService.swift - Website blocker → Blocker overlay: presents overlay
Sources/Renotch/Window/FocusBlockerOverlayController.swift - Pomodoro timer → Notifications: schedules alerts
Sources/Renotch/Services/TimerService.swift - App model → File shelf: adds files
Sources/Renotch/State/AppModel.swift - App model → Todo store: coordinates
Sources/Renotch/State/AppModel.swift - App model → Browser activity: coordinates
Sources/Renotch/State/AppModel.swift - App bootstrap → Extension installer: installs integration
Sources/Renotch/App/RenotchApp.swift - Browser extension → Browser activity: enables tracking
- YouTube content script → Browser extension: reports playback
- Browser bridge → Browser activity: relays activity