## Overview - Media controls for Apple Music, Spotify, and more with inline previews. - Live system insight (CPU, GPU, memory, network, disk) with lightweight graphs. - Productivity tools: clipboard history, colour picker, timers, calendar. - Optional minimalistic layout for a compact 420px notch footprint. ## Features - Media: artwork and transport controls, inline sneak-peek, adaptive lighting that subtly echoes album colours. - System: lightweight CPU/GPU/memory/network/disk graphs; drill into quick popovers when you need details. - Productivity: rich timers with live activity, precise colour picker with formats, and a searchable clipboard history. - Calendar: streamlined agenda with snapshot-driven updates to keep EventKit usage lean. - Lock Screen: weather, media, charging, and Bluetooth battery widgets that respect system accessory styles. - Customisation: minimalistic/standard layouts, animation styles, hover behaviour, and full shortcut remapping. ## Requirements - macOS 14.0 or later (optimised for macOS 15+). - MacBook with a notch (14/16‑inch MBP across Apple silicon generations). - Xcode 15+ to build from source. - Permissions as needed: Accessibility, Camera, Calendar, Screen Recording, Music. ## Installation 1) Clone and open the project ```bash git clone https://github.com/Ebullioscopic/Atoll.git cd Atoll open DynamicIsland.xcodeproj ``` 2) Select your Mac as the run destination, then build and run (⌘R). 3) Grant prompted permissions. The menu bar icon appears and the notch activates on hover. ## Quick Start - Hover near the notch to expand; click to enter controls. - Use tabs for Media, Stats, Timers, Clipboard, and more. - Toggle Minimalistic Mode from Settings for a smaller layout. ## Settings - Choose appearance, animation style, and per‑feature toggles. - Remap global shortcuts and adjust hover behaviour. - Enable lock screen widgets and select data sources. ## Troubleshooting (Basics) - After granting Accessibility or Screen Recording, quit and relaunch the app. - If metrics are empty, enable categories in Settings → Stats. - Media not responding: verify player is active and Music permission is granted. ## License Atoll is released under the GPL v3 License. Refer to [LICENSE](LICENSE) for the full terms. ## Acknowledgments Atoll builds upon the work of several open-source projects and draws inspiration from innovative macOS applications: - [**Boring.Notch**](https://github.com/TheBoredTeam/boring.notch) - foundational codebase that provided the initial media player integration, AirDrop surface implementation, file dock functionality, and calendar event display. Major architectural patterns and notch interaction models were adapted from this project. - [**Alcove**](https://tryalcove.com) - primary inspiration for the Minimalistic Mode interface design and the conceptual framework for lock screen widget integration that informed Atoll's compact layout strategy. - [**Stats**](https://github.com/exelban/stats) - source implementation for CPU temperature monitoring via SMC (System Management Controller) access, frequency sampling through IOReport bindings, and per-core CPU utilisation tracking. The system metrics collection architecture derives from Stats project readers. ## Contributors