This is @ronaldw07's fork of TheBoredTeam/boring.notch, with its own ongoing feature work — see What's New in This Fork below. All credit for the original app goes to TheBoredTeam; this fork builds on top of it.
Say hello to Boring Notch, the coolest way to make your MacBook’s notch the star of the show! Say goodbye to boring status bars: with Boring Notch, your notch transforms into a dynamic music control center, complete with a vibrant visualizer and all the essential music controls you need. But that’s just the start! Boring Notch also offers calendar integration, a handy file shelf with AirDrop support, a complete MacOS HUD replacement and more!
Everything below this line is original to this fork, on top of upstream 2.7.3. Full history in CHANGELOG.md.
- Added: Synced lyrics panel — scrub with two fingers or a mouse wheel, click a line to seek, toggled next to the mirror.
- Added: Pause music on mute, resume on unmute (Settings > Media).
- Added: Calendar toggle button, on by default.
- Fixed: Mirror/lyrics/calendar buttons now work from any tab, not just Home.
- Fixed: Calendar no longer polls in the background.
- Added: Select All / Deselect All button on the shelf, top-right under the battery indicator.
- Fixed: Dragging several selected shelf items out together now carries all of them, instead of collapsing to just the one card you pressed down on.
- Fixed: Clipboard history now captures from app launch instead of only after first opening the Clipboard tab — copies made before that were silently missed.
- Fixed: "Remember last tab" now actually remembers the last tab — it was silently overridden any time the shelf had files on it.
- Added: Shelf pinning — right-click an item to pin it; pinned items sort to the left and stay there.
- Added: Shelf stacks — dropping several files at once lands as one tile with a count badge, expandable in place, instead of overflowing the row.
- Added: Sticky multi-select — click multiple shelf items to highlight and drag/share them together.
- Changed: Removed the AirDrop / quick-share tile; sharing stays available through right-click and drag-out.
- Fixed: The shelf's horizontal scroll bar, which previously did nothing on drag.
- Added: Remove buttons and hover highlighting on shelf items.
- Added: Wheel/trackpad scrolling over the shelf row.
- Changed: Timer tab laid out as a row instead of a column, so it no longer grows the notch to fit itself.
- Fixed: Countdown timer no longer skips displaying 4:59.
- Fixed: Closing the notch now animates instead of teleporting, and no longer flickers or closes early mid-collapse.
System Requirements:
- macOS 14 Sonoma or later
- Apple Silicon or Intel Mac
Once downloaded, open the .dmg and move Boring Notch to your /Applications folder.
Important
We don't have an Apple Developer account (yet 👀), so macOS will warn you that Boring Notch is from an unidentified developer on first launch. This is expected behavior.
You'll need to bypass this before the app will open. You only need to do this once. Use one of the methods below.
This is the quickest and easiest method. It only requires a single command and works consistently for all users. System Settings can sometimes fail and won't work for non-admin users.
After moving Boring Notch to your Applications folder, run:
xattr -dr com.apple.quarantine /Applications/boringNotch.appThen open the app normally.
Note
This method doesn't work for all users. If this doesn't work, use the Terminal method above.
- Try to open the app — you'll see a security warning.
- Click OK to dismiss it.
- Open System Settings > Privacy & Security.
- Scroll to the bottom and click Open Anyway next to the Boring Notch warning.
- Confirm if prompted.
You can also install using Homebrew. The Homebrew installation automatically bypasses the macOS security warning described above.
brew install --cask TheBoredTeam/boring-notch/boring-notch- Launch the app, and voilà—your notch is now the coolest part of your screen.
- Hover over the notch to see it expand and reveal all its secrets.
- Use the controls to manage your music like a rockstar.
- Click the star in your menu bar to customize your notch to your heart's content.
- Playback live activity 🎧
- Calendar integration 📆
- Reminders integration ☑️
- Mirror 📷
- Charging indicator and current percentage 🔋
- Customizable gesture control 👆🏻
- Shelf functionality with AirDrop 📚
- Notch sizing customization, finetuning on different display sizes 🖥️
- System HUD replacements (volume, brightness, backlight) 🎚️💡⌨️
- Bluetooth Live Activity (connect/disconnect for bluetooth devices)
- Weather integration ⛅️
- Customizable Layout options 🛠️
- Lock Screen Widgets 🔒
- Extension system 🧩
- Notifications (under consideration) 🔔
- macOS 15.6 or later
- Xcode 26 or later
-
Clone the Repository:
git clone https://github.com/TheBoredTeam/boring.notch.git cd boring.notch -
Open the Project in Xcode:
open boringNotch.xcodeproj
-
Build and Run:
- Click the "Run" button or press
Cmd + R. Watch the magic unfold!
- Click the "Run" button or press
We’re all about good vibes and awesome contributions! Read CONTRIBUTING.md to learn how you can join the fun!
We would like to express our gratitude to the authors and maintainers of the open-source projects that made this possible.
- MediaRemoteAdapter – An open-source project that allowed us to use the Now Playing source in macOS 15.4+
- NotchDrop – An open-source project that has been instrumental in developing the first version of the "Shelf" feature in Boring Notch.
For a full list of licenses and attributions, please see the Third-Party Licenses file.
Icon credits: @maxtron95
Website credits: @himanshhhhuv
- SwiftUI: For making us look like coding wizards.
- You: For being awesome and checking out boring.notch!



