Boring Notch: what the MacBook notch utility actually does, and what it leaves out
TheBoringNotch: Not so boring notch That Rocks 🎸🎶
At a glance
- What is it?
- A look inside TheBoredTeam/boring.notch, a GPL-3.0 macOS app that turns the MacBook notch into a music control center, calendar readout, AirDrop shelf and replacement for the system HUD, plus the install step every manual user has to clear by hand and the roadmap items still empty.
- Who is it for?
- Boring Notch fits a Mac user who wants music controls, calendar and file shelf items gathered in one place, and who is willing to clear the unidentified developer warning once. Skip it if you need notifications in the notch, Bluetooth connect events, weather, or a documented way to hand brightness and volume back to the system, because those are unshipped or undocumented.
- Can I use it commercially?
- Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
- Is it still maintained?
- Yes. The repository received new commits within the last day.
- What is it written in?
- Mainly Swift, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- TheBoredTeam/boring.notch11,367 ★ · +548
| Repository | 2026-09-22 | 2026-11-15 |
|---|---|---|
| TheBoredTeam/boring.notch | 10.8k | 11.4k |
548 Stars in the last 54 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
The notch stays collapsed until the pointer reaches it
Boring Notch is a menu bar app that repurposes the physical notch on a MacBook instead of the status bar area around it. Move the pointer over the notch and it expands to reveal a music visualizer plus playback controls, and that hover is the only trigger the usage notes mention. Music is the core of the design rather than an extra panel: the project pitch is that the notch becomes a music control center, and playback live activity is the first item marked as shipped on the roadmap.
The README's usage notes describe hovering over the notch as the way it expands. The second thing the app adds is a star in the menu bar, and clicking that star is the documented entry point for customizing the notch.
The HUD swap takes over volume, brightness, and backlight keys
One of the checked roadmap items is system HUD replacements covering volume, brightness, and backlight, which means the app's own interface takes the place of the macOS panels those controls normally raise. That is a stronger claim than showing a battery number: the native feedback for a keypress now comes from a third-party app rather than from the system, and it shares the same screen real estate as the visualizer, the calendar, and the shelf.
The gain is that system feedback, music state, and file drops all arrive in one place. The cost is that the project does not document a per-control opt-out, a delay before the replacement appears, or a way to hand volume and brightness back to the stock system panel while keeping the music controls. Charging indicator and current percentage is a separate checked item, so battery state is shown regardless of whether the HUD swap is what you want. A reader who relies on the system's own brightness feedback, or who wants the notch reserved for music only, has to explore the settings behind the menu bar star, because the written documentation stops at listing the feature as done.
The unidentified developer warning has to be cleared by hand
The maintainers do not have an Apple Developer account, so every manual install hits a macOS warning that the project tells you to expect rather than report as a problem. The documentation is explicit that this is expected behavior and that the app will not open until you bypass it once. The recommended route is a single command, run after the app sits in your Applications folder:
xattr -dr com.apple.quarantine "/Applications/Boring Notch.app"An alternative route is System Settings: open the app, dismiss the warning, go to System Settings > Privacy & Security, scroll to the bottom, and click Open Anyway next to the Boring Notch warning. That path is marked as not working for all users, and System Settings is noted as sometimes failing and as unusable for non-admin users, which is why the Terminal method is the recommended one. Homebrew avoids the step entirely, because the cask install automatically bypasses the security warning:
brew install --cask TheBoredTeam/boring-notch/boring-notchThe consequence for a reader is real: the block is a permanent part of installation for anyone who drags the app out of the disk image, and the project-preferred fix is a command aimed at a hard-coded path containing a space in the app name. Rename the bundle after moving it and that exact path no longer points at your copy.
Building from source asks for a newer macOS than running the app
Runtime and build requirements sit at different levels. The released app targets macOS 14 Sonoma or later on either Apple Silicon or Intel. The source build asks for macOS 15.6 or later and Xcode 26 or later. So a checkout that produces a binary which runs on Sonoma cannot be compiled on Sonoma, and a contributor on an older Xcode is blocked even though the published app would run fine on their machine.
The build steps are a clone, an open, and a shortcut:
git clone https://github.com/TheBoredTeam/boring.notch.git
cd boring.notchopen boringNotch.xcodeprojThen click Run or press Cmd + R. The repository root carries no package manifest and no Makefile, and no headless build command is documented. Equally absent is any signing or notarization procedure for someone producing their own build, which is the part that matters if you ever try to hand that build to another Mac. The root does contain a directory named BoringNotchXPCHelper alongside updater/, Configuration/, and a bundled mediaremote-adapter/, so an out-of-the-box Xcode run is not a single-target project, yet nothing explains what the helper requires in order to run.
Nightly and v2.8 release candidates share one download link
The release feed carries three artifacts at once: a build tagged nightly, and two release candidates sharing the codename Dapper Crab, v2.8-rc.1 and v2.8-rc.2. Their dates are September 24, 2026 for the nightly, September 25 for v2.8-rc.1 and October 10 for v2.8-rc.2, so the candidate line is not behind the nightly even though the nightly is the entry listed first. Work on the default branch is current, with the most recent push dated November 2, 2026.
The manual install points at a single unversioned asset, the boringNotch.dmg file under the latest release download path, so the disk image you receive is whatever the latest release is at the moment you click. The documentation does not explain how to pin a specific build, and none of the install steps show a version string, which means two installs cannot be told apart from what is on screen. A reader who needs a reproducible setup, or who wants to compare a release candidate against the nightly, has to record the file itself. No documentation covers how either channel is versioned from the user's side.
Bluetooth, weather, and notifications are still empty boxes
The roadmap separates what ships from what does not, and the unshipped column is specific: Bluetooth live activity for device connect and disconnect events, weather integration, customizable layout options, lock screen widgets, an extension system, and notifications, which is annotated as under consideration rather than promised. A longer block of the same list sits commented out, including a clipboard history manager, download indicators for Safari, Chromium browsers, and Firefox, customizable function buttons, and an app switcher, with the clipboard history manager and the browser download indicator marked as extension work.
That layout tells a reader two things. First, the extension system is the delivery vehicle for several of the ideas people expect from a notch utility, and it sits near the bottom of the unfinished list, so anything framed as a plug-in does not exist today. Second, notifications and weather are the two entries most easily assumed present from how the app is described. The consequences are concrete: a reader waiting for notifications in the notch, a Bluetooth connect event, or a weather strip will not find them, and the customization that does exist is limited to what the star in the menu bar exposes, because customizable layout options remain unchecked.
Calendar, reminders, shelf, and mirror read data nothing documents
Several checked items are integrations rather than visuals: calendar integration, reminders integration, a shelf with AirDrop, a mirror, and a charging indicator with current percentage. Nothing states which calendar or reminder accounts are read, whether the app requests the matching system permission on first run, how many entries appear in the expanded notch, or what shows up when an account is empty or unreachable. AirDrop is described only as shelf functionality with AirDrop, and no destination folder, no history, and no file type or size limits are given. The mirror is listed with no stated resolution, camera source, or privacy note.
Notch sizing customization is documented as finetuning on different display sizes, with no list of supported models and no per-display override. Combined with the hover behavior, that leaves a reader guessing at the practical envelope of the app on an external monitor. The net result: the useful part of the feature list can only be verified after granting permissions and populating accounts, and the failure cases, which is where integrations of this kind usually break for people, are exactly the ones the project does not write down.
Now Playing on newer macOS rests on a borrowed adapter
The project credits MediaRemoteAdapter as the open-source work that allowed it to use the Now Playing source in macOS 15.4 and later, and it ships a mediaremote-adapter directory inside its own repository. NotchDrop is also credited as an open-source project that has been instrumental in the app's development. These credits also mark where behavior changes by system version: a Mac on macOS 15.4 or later travels a path through the adapter, while an earlier system still inside the stated macOS 14 Sonoma minimum is not covered by that credit.
Nothing documents what the app does for Now Playing below 15.4, whether the adapter is compiled from source as part of the Xcode run, or how a future change by Apple to the Now Playing source would reach people using the app. There is no compatibility table. A reader on an older but supported macOS should confirm that playback control actually populates the notch before making it their primary way to control music.
Editorial conclusion
Boring Notch fits a Mac user who wants music controls, calendar and file shelf items gathered in one place, and who is willing to clear the unidentified developer warning once. Skip it if you need notifications in the notch, Bluetooth connect events, weather, or a documented way to hand brightness and volume back to the system, because those are unshipped or undocumented. Check your macOS version first, since playback on the Now Playing source is credited to an adapter written for macOS 15.4 and later.
Frequently asked questions
What is the boring notch?
Boring Notch is a macOS app that expands the MacBook notch into a music control center with a visualizer and playback controls, and it also adds calendar integration, a file shelf with AirDrop, and replacements for the system volume, brightness, and backlight panels.
Why is Boring.Notch not open?
The maintainers do not have an Apple Developer account, so macOS warns that the app is from an unidentified developer on first launch. The app will not start until you clear that once with xattr -dr com.apple.quarantine on the app, or with Open Anyway in System Settings under Privacy & Security.
How do I install Boring Notch on my Mac?
Download the boringNotch.dmg from the latest release, move Boring Notch into your Applications folder, then run xattr -dr com.apple.quarantine "/Applications/Boring Notch.app" and open it. Homebrew users can run brew install --cask TheBoredTeam/boring-notch/boring-notch instead, which bypasses the warning automatically.
How do I install Boring Notch on my MacBook?
The requirements are macOS 14 Sonoma or later on either Apple Silicon or Intel. The manual disk image route needs the quarantine bypass, while the Homebrew cask handles it for you. Building from source is a separate matter and needs macOS 15.6 or later with Xcode 26 or later.
how to use boring notch
Launch the app, then hover over the notch so it expands and shows the visualizer and music controls. Use those controls to manage playback. Clicking the star in the menu bar is how you customize the notch.
how to access boring notch settings
The star in the menu bar is the documented control surface. Clicking it opens the customization for the notch, and the roadmap lists notch sizing customization and customizable gesture control as shipped features.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/theboredteam-boring-notch)Star history chart for your README
[](https://hysenlabs.com/projects/theboredteam-boring-notch)Was this useful?