How is52hertz/relay works
Relay is a native macOS menu-bar app switcher: users create Profiles, bind global hotkeys to target apps, choose reusable state-based activation behaviors, then trigger those bindings from anywhere. The active Profile’s bindings are registered and dispatched to the activation engine, which inspects app state and performs the configured action. Separate branches cover settings, local configuration and backup management. The graph uses the README and source index references; unsampled implementations are represented only where documented or referenced, so some internal wiring is omitted.
Main entry points: AppModel.swift App Model · AppActivationService.swift Activation Service · AppController.swift App Controller · RelayApp.swift Relay App
Components 25
App Shell
- Relay App
Relay/Relay/RelayApp.swift - App Controller
Relay/Relay/State/AppController.swift - Menu Bar
Relay/Relay/UI/MenuBarContent.swift
Profiles and Hotkeys
- Profiles UI
Relay/Relay/UI/ProfilesView.swift - Binding Editor
Relay/Relay/UI/BindingsDetailView.swift - Shortcut Recorder
Relay/Relay/UI/ShortcutRecorder.swift - Hotkey Registration
Relay/Relay/Services/HotkeyRegistrationService.swift
Activation Engine
- Activation Service
Relay/Relay/Services/AppActivationService.swift - Activation Decisions
Relay/Relay/Services/AppActivationDecision.swift - Target App Resolver
Relay/Relay/Services/TargetAppResolver.swift - Frontmost Tracker
Relay/Relay/Services/FrontmostTracker.swift - Window Minimizer
Relay/Relay/Services/WindowMinimizer.swift
Configuration and Data
- App Model
Relay/Relay/State/AppModel.swift - Configuration Models
Relay/Relay/Models/AppConfiguration.swift - Local Persistence
Relay/Relay/Persistence/PersistenceStore.swift - Data Settings
Relay/Relay/UI/DataSettingsView.swift - Backup Service
Relay/Relay/Services/BackupService.swift
Settings and Services
- Settings UI
Relay/Relay/UI/GeneralSettingsView.swift - Personalization UI
Relay/Relay/UI/PersonalizationSettingsView.swift - Language Service
Relay/Relay/Services/LanguageService.swift - Login Item Service
Relay/Relay/Services/LoginItemService.swift - Dock Icon Controller
Relay/Relay/Services/DockIconController.swift
Other components
- User
- KeyboardShortcuts
- macOS AppKit
Connections 31
- User → Relay App: opens
README.md - Relay App → App Controller: creates
Relay/Relay/RelayApp.swift - Relay App → Menu Bar: presents
Relay/Relay/RelayApp.swift - Relay App → Profiles UI: presents
Relay/Relay/RelayApp.swift - User → Profiles UI: manages profiles
README.md - Profiles UI → Binding Editor: shows details
Relay/Relay/UI/ProfilesView.swift - Binding Editor → App Model: edits bindings
Relay/Relay/UI/BindingsDetailView.swift - Binding Editor → Shortcut Recorder: uses recorder
Relay/Relay/UI/BindingsDetailView.swift - App Model → Local Persistence: loads and saves
Relay/Relay/State/AppModel.swift - App Model → Configuration Models: holds
Relay/Relay/State/AppModel.swift - App Controller → App Model: creates
Relay/Relay/State/AppController.swift - App Controller → Hotkey Registration: configures
Relay/Relay/State/AppController.swift - App Model → Hotkey Registration: signals profile changes
Relay/Relay/State/AppController.swift - Hotkey Registration → KeyboardShortcuts: registers shortcuts
Relay/Relay/Services/HotkeyRegistrationService.swift - Hotkey Registration → Activation Service: dispatches bindings
Relay/Relay/Services/HotkeyRegistrationService.swift - Activation Service → Activation Decisions: selects action
Relay/Relay/Services/AppActivationService.swift - Activation Service → Target App Resolver: checks app state
Relay/Relay/Services/AppActivationService.swift - Activation Service → Frontmost Tracker: checks foreground
Relay/Relay/Services/AppActivationService.swift - Activation Service → Window Minimizer: controls windows
Relay/Relay/Services/AppActivationService.swift - Activation Service → macOS AppKit: launches and focuses
README.md - Window Minimizer → macOS AppKit: uses Accessibility
README.md - User → Data Settings: manages backups
README.md - Data Settings → App Model: reads configuration
Relay/Relay/UI/DataSettingsView.swift - Data Settings → Backup Service: imports and exports
Relay/Relay/UI/DataSettingsView.swift - Backup Service → Local Persistence: uses data directory
Relay/Relay/Services/BackupService.swift - User → Settings UI: changes settings
README.md - Settings UI → App Model: updates preferences
- Personalization UI → App Model: updates language choice
Relay/Relay/UI/PersonalizationSettingsView.swift - Personalization UI → Language Service: requests language change
Relay/Relay/UI/PersonalizationSettingsView.swift - App Controller → Login Item Service: applies login setting
Relay/Relay/State/AppController.swift - App Controller → Dock Icon Controller: applies Dock setting
Relay/Relay/State/AppController.swift