How fif7y/pelmet works
Pelmet is a native macOS menu-bar organizer: users assign icons to Visible, Hidden, and Always Hidden, then reveal them on demand or apply an edited layout. AppState coordinates the section model, the menu-bar engine, settings, and interactions; the engine observes and rearranges items while macOS performs native hiding. The README documents additional display rules, built-in replacement items, separators, animation, onboarding, and signed updates. Several feature implementations are unsampled, so those branches are shown at their documented subsystem paths; edges are limited to documented or indexed relationships.
Main entry points: AppState.swift AppState · AgentBarEngine.swift Bar engine · TransitionCoordinator.swift Reveal transitions · SectionModel.swift Section model
Components 24
Policy and layout
- Settings store
Packages/PelmetCore/Sources/PelmetCore/SettingsStore.swift - Section model
Packages/PelmetCore/Sources/PelmetCore/SectionModel.swift - Menu bar policy
Packages/PelmetCore/Sources/PelmetCore/MenuBarPolicy.swift - Placement geometry
Packages/PelmetCore/Sources/PelmetCore/PlacementGeometry.swift
Menu bar engine
- Bar engine
Packages/PelmetEngine/Sources/PelmetEngine/AgentBarEngine.swift - Item enumeration
Packages/PelmetEngine/Sources/PelmetEngine/ItemEnumerator.swift - Engine interface
Packages/PelmetEngine/Sources/PelmetEngine/MenuBarEngine.swift - Accessibility access
Pelmet/App/AccessibilityAccess.swift
App coordination
- Pelmet app
Pelmet/App/PelmetApp.swift - AppState
Pelmet/App/AppState.swift
Interaction and editor
- Editor items
Pelmet/App/EditorItemsBuilder.swift - Apply pass
Pelmet/App/ApplyPass.swift - Reveal interactions
Pelmet/Events - Reveal transitions
Pelmet/App/TransitionCoordinator.swift - Status item
Pelmet/StatusItem/PelmetStatusItem.swift - Animation overlay
Pelmet/StatusItem/ConcealGhostOverlay.swift - Settings and editor UI
Pelmet/Settings
User features
- Built-in extras
Pelmet/Extras - Separators
Pelmet/StatusItem/SeparatorManager.swift - Onboarding
Pelmet/Onboarding/OnboardingController.swift - Signed updater
Pelmet/Update/SparkleController.swift
Other components
- User
- macOS menu bar
- Sparkle update service
Connections 29
- User → Pelmet app: launches
- AppState → Settings store: reads and writes
Pelmet/App/AppState.swift - AppState → Bar engine: coordinates
Pelmet/App/AppState.swift - Bar engine → Section model: converges toward
Packages/PelmetEngine/Sources/PelmetEngine/AgentBarEngine.swift - Bar engine → Engine interface: uses
Packages/PelmetEngine/Sources/PelmetEngine/AgentBarEngine.swift - Bar engine → Item enumeration: refreshes from
Packages/PelmetEngine/Sources/PelmetEngine/AgentBarEngine.swift - Bar engine → macOS menu bar: asserts visibility and moves
README.md - Bar engine → Accessibility access: observes and clicks via
README.md - Section model → Menu bar policy: consults
Packages/PelmetCore/Sources/PelmetCore/SectionModel.swift - User → Settings and editor UI: edits layout
README.md - Settings and editor UI → Editor items: builds item tiles
- Editor items → Section model: reads assignments
Pelmet/App/EditorItemsBuilder.swift - User → AppState: applies layout
README.md - AppState → Apply pass: starts apply pass
Pelmet/App/AppState.swift - Apply pass → Bar engine: moves items
Pelmet/App/ApplyPass.swift - User → Reveal interactions: requests reveal
README.md - Reveal interactions → AppState: signals interactions
Pelmet/Events/MenuBarBandMonitor.swift - AppState → Reveal transitions: coordinates transitions
Pelmet/App/AppState.swift - Reveal transitions → Bar engine: converges visibility
Pelmet/App/TransitionCoordinator.swift - Reveal transitions → Animation overlay: animates over bar
Pelmet/App/TransitionCoordinator.swift - AppState → Status item: updates status item
Pelmet/App/AppState.swift - AppState → Built-in extras: coordinates extras
Pelmet/Extras/MediaControls.swift - AppState → Separators: coordinates separators
Pelmet/App/AppState.swift - User → Onboarding: grants permissions
README.md - AppState → Onboarding: presents onboarding
Pelmet/App/AppState.swift - User → Signed updater: checks for updates
README.md - Signed updater → Sparkle update service: checks signed releases
README.md - User → macOS menu bar: uses native menu bar
README.md - Placement geometry → Editor items: supports placement
Pelmet/App/EditorItemsBuilder.swift