How dwarvesf/hidden works
Hidden Bar is a macOS menu-bar utility for organizing and hiding status items. The main workflow is a user toggling the arrow: the status-bar controller asks the selected engine to collapse or expand the bar, using either separator sizing or native visibility restrictions. Preferences also control auto-hide, startup, shortcuts, separators, and notch overflow. The graph distinguishes the engine implementations and the notch-overflow path; unsampled subsystems are represented only where their paths are supported by the tree and README.
Main entry points: StatusBarController.swift Status bar controller · NativeVisibilityEngine.swift Native visibility · AppDelegate.swift App delegate · MenuBarEngineFactory.swift Engine selection
Components 20
App coordination
- App delegate
hidden/AppDelegate.swift
Menu bar control
- Status bar controller
hidden/Features/StatusBar/StatusBarController.swift - Expand/collapse action
hidden/Features/StatusBar/ExpandCollapseAction.swift - Engine selection
hidden/Features/StatusBar/Engine/MenuBarEngineFactory.swift - Engine contract
hidden/Features/StatusBar/Engine/MenuBarEngine.swift - Separator sizing
hidden/Features/StatusBar/Engine/LegacyLengthEngine.swift - Native visibility
hidden/Features/StatusBar/Engine/NativeVisibilityEngine.swift - Menu bar inventory
hidden/Features/StatusBar/Layout/AccessibilityMenuBarInventory.swift - Section layout
hidden/Features/StatusBar/Layout/MenuBarLayout.swift - Visibility bridge
hidden/Features/StatusBar/Engine/Native/NativeVisibilityBridge.swift
Settings
- Preferences UI
hidden/Features/Preferences/PreferencesViewController.swift - Preferences window
hidden/Features/Preferences/PreferencesWindowController.swift - Preference values
hidden/Common/Preferences.swift - Startup management
hidden/Common/AutoStart.swift - Shortcut preferences
hidden/Models/GlobalKeybindingPreferences.swift
Notch overflow
- Notch overflow
hidden/Features/NotchOverflow/NotchOverflowController.swift
Other components
- Mac user
- macOS services
- System status items
- User defaults
Connections 25
- Mac user → Status bar controller: toggles arrow
- Status bar controller → Engine selection: selects engine
- Engine selection → Separator sizing: chooses fallback
- Engine selection → Native visibility: chooses native
- Separator sizing → Engine contract: implements
- Native visibility → Engine contract: implements
- Status bar controller → Engine contract: collapses or expands
- Separator sizing → System status items: resizes separators
- Native visibility → Menu bar inventory: reads sections
- Menu bar inventory → macOS services: requests accessibility
- Native visibility → Section layout: resolves sections
- Native visibility → Visibility bridge: activates restrictions
- Visibility bridge → macOS services: sets visibility
- Mac user → Preferences UI: changes settings
- Status bar controller → Preferences window: opens preferences
- Preferences window → Preferences UI: shows settings
- Preferences UI → Preference values: updates values
- Preference values → User defaults: reads and writes
- App delegate → Startup management: configures startup
- Startup management → macOS services: registers login
- App delegate → Preference values: loads defaults
- App delegate → Status bar controller: creates controller
- Status bar controller → Notch overflow: opens overflow
- Notch overflow → macOS services: enumerates and activates extras
- Mac user → Notch overflow: browses notch items