How ebullioscopic/atoll works
Atoll is a macOS notch-based command surface. Users open the notch, choose a surface such as Media, Stats, or Timers, and interact with native controls backed by media controllers, system monitors, and utility managers. It also presents Live Activities and configurable lock-screen widgets. The README documents these major capabilities; sampled excerpts show details of media control, usage refresh, temporary-file handling, sharing lifecycle, and screen-capture visibility, but do not establish every runtime connection, so uncertain wiring is omitted.
Main entry points: MusicManager.swift Music manager · DynamicIslandApp.swift App lifecycle · NotchHomeView.swift Notch surfaces · SpotifyController.swift Spotify controller
Components 27
App Surface
- App lifecycle
DynamicIsland/DynamicIslandApp.swift - Island coordinator
DynamicIsland/DynamicIslandViewCoordinator.swift - Notch surfaces
DynamicIsland/components/Notch/NotchHomeView.swift - Settings
DynamicIsland/components/Settings/SettingsView.swift - Capture visibility
DynamicIsland/helpers/ScreenCaptureVisibilityManager.swift
Media
- Music manager
DynamicIsland/managers/MusicManager.swift - Controller protocol
DynamicIsland/MediaControllers/MediaControllerProtocol.swift - Spotify controller
DynamicIsland/MediaControllers/SpotifyController.swift - YouTube Music
DynamicIsland/MediaControllers/YouTube Music Controller/YouTubeMusicController.swift - Music controls
DynamicIsland/components/Notch/MinimalisticMusicPlayerView.swift
System Insight
- Stats manager
DynamicIsland/managers/StatsManager.swift - System metrics UI
DynamicIsland/components/Stats/CPUStatsDetailView.swift - Audio visualization
DynamicIsland/audio/AudioVisualizerView.swift - System HUDs
DynamicIsland/managers/SystemHUDManager.swift
Utilities
- Timer service
DynamicIsland/managers/TimerManager.swift - Clipboard tools
DynamicIsland/managers/ClipboardManager.swift - Calendar service
DynamicIsland/managers/CalendarManager.swift - File Shelf
DynamicIsland/components/Shelf/Views/ShelfView.swift - LLM usage
DynamicIsland/managers/LLMUsage/LLMUsageManager.swift
Lock Screen & Extensions
- Lock-screen manager
DynamicIsland/managers/LockScreenManager.swift - Lock-screen widgets
DynamicIsland/components/LockScreen/LockScreenLiveActivity.swift - Extension RPC
DynamicIsland/services/Extensions/ExtensionRPCService.swift - Extension widgets
DynamicIsland/managers/Extensions/ExtensionLockScreenWidgetPresentationController.swift
Other components
- Mac user
- Spotify app
- YouTube Music app
- macOS services
Connections 25
- Mac user → App lifecycle: launches
- App lifecycle → Island coordinator: starts
- Mac user → Notch surfaces: opens
- Notch surfaces → Music controls: shows media
- Music controls → Music manager: requests playback
- Music manager → Controller protocol: uses
- Music manager → Spotify controller: selects
- Music manager → YouTube Music: selects
- Spotify controller → Spotify app: controls and reads
- YouTube Music → YouTube Music app: controls and reads
- Mac user → System metrics UI: opens metrics
- System metrics UI → Stats manager: displays metrics
- Mac user → Audio visualization: views spectrum
- Mac user → System HUDs: triggers HUD
- Mac user → Timer service: sets timer
- Mac user → Clipboard tools: uses clipboard
- Mac user → Calendar service: views calendar
- Mac user → File Shelf: drops files
- Mac user → LLM usage: checks usage
- Mac user → Settings: customizes
- Mac user → Lock-screen widgets: views widgets
- Lock-screen manager → Lock-screen widgets: presents
- Extension RPC → Extension widgets: delivers payloads
- Extension widgets → macOS services: creates windows
- Capture visibility → macOS services: sets capture visibility