Skip to content

macanoclothing-blip/Atoll

 
 

Repository files navigation

Atoll logo

GitHub stars GitHub forks GitHub downloads Discord server

Sponsor Ebullioscopic Download Atoll for macOS Buy Me a Coffee for kryoscopic

Join our Discord community

Project rename: DynamicIsland is now called Atoll. Visit the new repository at github.com/Ebullioscopic/Atoll.

Atoll

Atoll turns the MacBook notch into a focused command surface for media, system insight, and quick utilities. It stays out of the way until needed, then expands with responsive, native SwiftUI animations.

UI Modes

Minimalistic Mode

  • Compact layout focused on core actions and quick glance info.
  • Ideal when you want media and essentials without wider panels.

Minimalistic UI

Standard Mode

  • Full-width experience with richer layouts, panels, and context.
  • Best for deep control of media, stats, and productivity tools.

Standard UI

Calendar & Reminders

  • Clean calendar panel with upcoming events and reminders.
  • Efficient EventKit usage to minimise refreshes and background churn.
  • Clear timeline of upcoming items; grants only when you approve Calendar access.

Calendar and reminders

Timers

  • Named timers with live activity state, clear progress, and alerts.
  • Choose circular ring or linear bar; pick tints that match your setup.
  • Controls live both in the notch and via menu bar for quick access.

Timers

Do Not Disturb

  • One-tap Focus toggle with immediate visual feedback near the notch.
  • See current status at a glance without digging through menus.

Do Not Disturb

Lock Screen Widgets

  • Media playback controls with artwork and transport.
  • Active timer progress with visual feedback.
  • Device charging status and battery levels.
  • Connected Bluetooth devices and their battery states.
  • Current weather conditions and forecast.

Do Not Disturb

Live Activities

  • Media Playback
  • Focus Mode
  • Screen Recording
  • Microphone, Camera Privacy Indicators
  • Connected Bluetooth Devices
  • Download progress beta
  • Low Battery status, Charging

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
git clone https://github.com/Ebullioscopic/Atoll.git
cd Atoll
open DynamicIsland.xcodeproj
  1. Select your Mac as the run destination, then build and run (⌘R).
  2. 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 for the full terms.

Acknowledgments

Atoll builds upon the work of several open-source projects and draws inspiration from innovative macOS applications:

  • 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 - 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 - 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.

  • Open Meteo - weather apis for the lock screen widgets

  • SkyLightWindow - window rendering for Lock Screen Widgets

Contributors

Star History

Star History Chart

Updating Existing Clones

If you previously cloned DynamicIsland, update the remote to track the Atoll repository:

git remote set-url origin https://github.com/Ebullioscopic/Atoll.git

A heartfelt thanks to TheBoredTeam for being supportive and being totally awesome, Atoll would not have been possible without Boring.Notch


iOS Development Centre exterior
Backed by
iOS Development Centre
Powered by Apple and Infosys
SRM Institute of Science and Technology, Chennai, India

About

Dynamic Island for MacBook M3, M4

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Swift 99.6%
  • Other 0.4%