How ylam18/flower-hud works
Flower is a macOS menu-bar quick-launcher: the user holds a configurable global trigger, chooses an app or command from a radial overlay, and releases to run it. Apps can come from the live Dock or a saved custom preset; app petals can expand into open-window choices, with optional live previews. Settings cover presets, triggers, themes, and permissions. The graph reflects README statements and the supplied source excerpts/index; some internal dispatch details are unsampled, so uncertain links are omitted or marked dashed.
Main entry points: FlowerController.swift Flower controller · SettingsView.swift Settings view · AppDelegate.swift App delegate · TriggerMonitor.swift Trigger monitor
Components 24
Runtime and triggers
- App delegate
Sources/FlowerHUD/AppDelegate.swift - Trigger monitor
Sources/FlowerHUD/Trigger/TriggerMonitor.swift - Trigger model
Sources/FlowerHUD/Trigger/Trigger.swift
Flower overlay
- Flower controller
Sources/FlowerHUD/Flower/FlowerController.swift - Flower view
Sources/FlowerHUD/Flower/FlowerView.swift - Flower panel
Sources/FlowerHUD/Flower/FlowerPanel.swift - Window preview panel
Sources/FlowerHUD/Flower/PreviewPanel.swift - Flower themes
Sources/FlowerHUD/Flower/FlowerTheme.swift
Apps and actions
- Preset store
Sources/FlowerHUD/Apps/PresetStore.swift - Dock reader
Sources/FlowerHUD/Apps/DockReader.swift - App item
Sources/FlowerHUD/Apps/AppItem.swift - Petal actions
Sources/FlowerHUD/Apps/PetalItem.swift - Petal launcher
Sources/FlowerHUD/Apps/PetalLauncher.swift - App launcher
Sources/FlowerHUD/Apps/AppLauncher.swift - Window enumerator
Sources/FlowerHUD/Apps/WindowEnumerator.swift - Window capture
Sources/FlowerHUD/Apps/WindowCapture.swift
Settings and permissions
- Accessibility access
Sources/FlowerHUD/Permissions/Accessibility.swift - Permission onboarding
Sources/FlowerHUD/Permissions/Onboarding.swift - Screen Recording access
Sources/FlowerHUD/Permissions/ScreenRecording.swift - Settings view
Sources/FlowerHUD/Settings/SettingsView.swift - Command editor
Sources/FlowerHUD/Settings/CommandEditor.swift - Trigger recorder
Sources/FlowerHUD/Settings/TriggerRecorder.swift
Other components
- User
- macOS services
Connections 35
- User → Trigger monitor: holds trigger
README.md - App delegate → Trigger monitor: starts monitor
Sources/FlowerHUD/AppDelegate.swift - App delegate → Flower controller: configures overlay
Sources/FlowerHUD/AppDelegate.swift - App delegate → Preset store: uses settings
Sources/FlowerHUD/AppDelegate.swift - App delegate → Petal launcher: sets up actions
Sources/FlowerHUD/AppDelegate.swift - Trigger monitor → Trigger model: matches binding
Sources/FlowerHUD/Trigger/TriggerMonitor.swift - Trigger monitor → Flower controller: summons overlay
- Flower controller → Flower view: updates display
Sources/FlowerHUD/Flower/FlowerController.swift - Flower controller → Flower panel: shows overlay
Sources/FlowerHUD/Flower/FlowerController.swift - Flower controller → Window enumerator: reads app windows
Sources/FlowerHUD/Flower/FlowerController.swift - Flower controller → Window capture: captures previews
Sources/FlowerHUD/Flower/FlowerController.swift - Flower controller → Window preview panel: shows thumbnail
Sources/FlowerHUD/Flower/FlowerController.swift - Window preview panel → Flower themes: uses colors
Sources/FlowerHUD/Flower/PreviewPanel.swift - Flower view → Flower themes: renders with
Sources/FlowerHUD/Flower/FlowerView.swift - Flower controller → Petal launcher: dispatches selection
- Petal launcher → App launcher: launches app
Sources/FlowerHUD/Apps/PetalLauncher.swift - Petal launcher → Window enumerator: dispatches window actions
Sources/FlowerHUD/Apps/PetalLauncher.swift - Window enumerator → App launcher: launches if needed
Sources/FlowerHUD/Apps/WindowEnumerator.swift - App launcher → macOS services: opens application
README.md - Window capture → macOS services: captures screen
README.md - Window enumerator → Accessibility access: uses AX access
Sources/FlowerHUD/Apps/WindowEnumerator.swift - Preset store → Dock reader: reads Dock source
Sources/FlowerHUD/Apps/PresetStore.swift - Preset store → Petal actions: stores custom items
Sources/FlowerHUD/Apps/PresetStore.swift - Preset store → App item: migrates app entries
Sources/FlowerHUD/Apps/PresetStore.swift - Settings view → Preset store: edits presets
Sources/FlowerHUD/Settings/SettingsView.swift - Settings view → Command editor: edits commands
Sources/FlowerHUD/Settings/SettingsView.swift - Settings view → Trigger recorder: records trigger
Sources/FlowerHUD/Settings/SettingsView.swift - Settings view → Dock reader: offers Dock source
Sources/FlowerHUD/Settings/SettingsView.swift - Settings view → Accessibility access: checks permission
Sources/FlowerHUD/Settings/SettingsView.swift - Settings view → Flower themes: selects theme
Sources/FlowerHUD/Settings/SettingsView.swift - App delegate → Permission onboarding: starts first-run guide
Sources/FlowerHUD/AppDelegate.swift - Permission onboarding → Accessibility access: checks access
Sources/FlowerHUD/Permissions/Onboarding.swift - Permission onboarding → Screen Recording access: checks access
Sources/FlowerHUD/Permissions/Onboarding.swift - Trigger monitor → Accessibility access: requires permission
README.md - User → Settings view: configures launcher
README.md