Open-source project
TheBoredTeam/boring.notch avatar
TheBoredTeam/boring.notch

Boring Notch: turning the MacBook notch into a music and system control surface

TheBoringNotch: Not so boring notch That Rocks 🎸🎶

10,890 stars1,050 forksSwiftGPL-3.0

At a glance

What is it?
Boring Notch is a GPL-3.0 macOS app that expands the camera notch into a music player, calendar, file shelf, mirror and HUD replacement. It needs macOS 14 or later, and the first launch requires bypassing Gatekeeper because the project has no Apple Developer account.
Who is it for?
Adopt Boring Notch if you run macOS 14 Sonoma or later on a MacBook and want media controls, a file shelf with AirDrop and HUD replacement attached to the notch. Skip it if you are on macOS 13 or older, or if you cannot accept a GPL-3.0 app that is not signed with an Apple Developer certificate.
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 last received commits 2 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 27, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

The problem Boring Notch addresses on notched MacBooks

On MacBooks with a camera notch, the cutout is dead space. macOS draws the menu bar around it, and nothing else uses the area. Boring Notch treats that cutout as an interactive surface: hovering over the notch expands it into a panel with music controls and a visualizer, according to the README. The project also replaces the system HUD for volume, brightness and keyboard backlight, adds calendar and reminders integration, a file shelf that supports AirDrop, a mirror, and a charging indicator with current battery percentage. The target user is a MacBook owner running macOS 14 Sonoma or later who wants those functions attached to the notch instead of scattered across menu bar utilities. The repository lists the app as Swift, licensed GPL-3.0, with the homepage at theboring.name. The last push to the main branch was on 2026-09-21, and a nightly dev build (nightly-dev-f6245e1-274) was published the same day, so the codebase is moving. The most recent stable release in the repository's release list is v2.7.3 from 2025-11-24.

How the notch expansion and HUD replacement work

The README describes the interaction model in plain terms: launch the app, hover over the notch to expand it, use the controls to manage music, and click the star in the menu bar to customize the notch. That is the visible layer. Underneath, the repository layout shows the pieces that make it work. There is a mediaremote-adapter directory, which is where the app hooks into macOS media remote information to read what is playing and to send playback commands. There is a BoringNotchXPCHelper directory, an XPC helper target, which is the usual way a sandboxed or partially sandboxed app asks a separate process to do work it cannot do itself, such as reading system state or controlling hardware-adjacent features. There is an updater directory for the in-app update mechanism, a Configuration directory, and the main boringNotch source directory alongside the Xcode project. The HUD replacement, the charging indicator and the gesture control all sit in that main app target. The README does not document the internal data flow between the media adapter and the UI, so the exact call path from a track change to the visualizer is not something the documentation spells out. What can be said from the layout is that media state and system state are read through separate mechanisms, one for media and one via XPC, rather than a single privileged process doing everything.

Installing Boring Notch on a Mac

The README gives two installation paths. The manual path is a DMG from the releases page; the Homebrew path is a cask. Both require macOS 14 Sonoma or later, and the README states the app runs on Apple Silicon or Intel Macs.

For the Homebrew route, the README gives this exact command, and notes that the Homebrew installation automatically bypasses the macOS security warning:

bash
brew install --cask TheBoredTeam/boring-notch/boring-notch

For the manual route, download the DMG from the latest release, open it, and move Boring Notch to /Applications. The README is explicit that the project does not have an Apple Developer account, so macOS will report the app as being from an unidentified developer on first launch. The recommended fix is a single Terminal command after the app is in Applications:

bash
xattr -dr com.apple.quarantine /Applications/boringNotch.app

The README says this only needs to be done once, and that it works consistently for all users, including non-admin users. It also offers a System Settings alternative under Privacy & Security with an Open Anyway button, but warns that this method does not work for everyone. Once the app opens, hovering over the notch expands it, and the star in the menu bar opens customization. The README does not document a settings file path or a command-line configuration interface, so customization is done through that in-app menu.

Building Boring Notch from source, and the version gap

The build requirements are stricter than the runtime requirements, which is worth noticing. The README asks for macOS 15.6 or later and Xcode 26 or later to build from source, while the app itself runs on macOS 14. Anyone on Sonoma who wants to compile rather than download is out of luck per those instructions. The build steps are three commands, and the README presents them without extra flags:

bash
git clone https://github.com/TheBoredTeam/boring.notch.git
cd boring.notch
open boringNotch.xcodeproj

After that, the README says to press Cmd + R in Xcode. There is no mention of a dependency manager, a package resolution step, or a build script, which fits a project whose top-level entries are an Xcode project, source directories and configuration rather than a Package.swift. The other thing to weigh is the release cadence. The release list shows a nightly dev build dated 2026-09-21 and a stable release, v2.7.3, dated 2025-11-24. That is roughly ten months between the newest stable tag and the nightly. If you install from the releases page you get the stable line; if you want the features that landed after v2.7.3, you are looking at a nightly build with the usual caveats about untagged changes. The README does not describe a rollback procedure, and there is no documented downgrade path in the repository.

Where Boring Notch is the wrong tool

The hard boundary is hardware. Boring Notch is built around the notch, so on a Mac without one, the central interaction surface does not exist. Mac minis, Mac Studios, and older MacBook Air and Pro models without the cutout are not the intended target, and the README does not claim otherwise. The second boundary is the operating system. macOS 14 Sonoma is the stated minimum, and the README does not offer a fallback for macOS 13 or earlier. The third is distribution. Because the project has no Apple Developer account, the app is not notarized, and every manual install requires either the xattr command or the Homebrew cask to get past Gatekeeper. Users who cannot run Terminal commands on their machine, or who are on managed devices where the security policy blocks unidentified developers, will not get the app to launch. That is not a bug to be fixed in a patch; it is a consequence of the signing situation the README describes. A fourth consideration is scope. The roadmap lists Bluetooth live activity, weather, customizable layouts, lock screen widgets, an extension system and notifications as unchecked items, so anyone expecting an extension ecosystem today will not find one, and the README's extension section is commented out in the source.

How Boring Notch differs from menu bar utilities like Ice or Bartender

The closest comparison is a menu bar manager such as Ice or Bartender. Those tools take the existing menu bar and reorganize it: hiding icons, grouping them, collapsing them behind a bar. Boring Notch does not manage the menu bar. It adds a new surface at the notch and replaces specific system overlays, the volume, brightness and keyboard backlight HUDs, with its own rendering. The difference in approach matters for what each tool can do. A menu bar manager can only rearrange what other apps put in the menu bar; it cannot show a music visualizer, hold a file shelf, or draw a mirror. Boring Notch cannot hide or reorder your existing menu bar icons, because that is not what it does. If your complaint is a cluttered menu bar, a manager is the right category. If your complaint is that the notch is wasted space and the system HUDs look dated, Boring Notch is the relevant category. There is overlap in that both change what you see at the top of the screen, but they operate on different objects: one on existing menu bar items, the other on the notch and the system overlays.

Licence, updates and the cost of staying current

Boring Notch is GPL-3.0. For an end user installing a DMG or a cask, that mostly means the source is available and the licence terms travel with the binary. For anyone building from source or planning to redistribute, GPL-3.0 carries obligations that a permissive licence does not, and the repository includes a THIRD_PARTY_LICENSES file alongside the LICENSE file, which suggests bundled components with their own terms. This is not legal advice; read the licence text if redistribution matters to you. On upgrades, the repository contains an updater directory, so the app has its own update mechanism rather than relying solely on manual DMG downloads. The Homebrew cask provides a second upgrade path, since brew upgrade --cask will pull a newer version. The cost of staying current is the gap between the stable tag and the nightly: the release list shows v2.7.3 as the newest stable release and a nightly build from 2026-09-21. Users who want fixes that landed after v2.7.3 have to choose between waiting for the next stable tag and running a nightly. The README does not document what changes between a nightly and a stable release, nor does it describe a channel-switching procedure.

Editorial conclusion

Adopt Boring Notch if you run macOS 14 Sonoma or later on a MacBook and want media controls, a file shelf with AirDrop and HUD replacement attached to the notch. Skip it if you are on macOS 13 or older, or if you cannot accept a GPL-3.0 app that is not signed with an Apple Developer certificate. Verify three things before installing: that your macOS version meets the stated requirement, that you are willing to run the xattr command or use the Homebrew cask to clear the quarantine flag, and that you are comfortable with the notch area as the interaction surface for calendar, shelf and mirror features.

Frequently asked questions

What is Boring Notch?

It is a macOS app that turns the MacBook notch into an interactive panel with music controls and a visualizer, plus calendar and reminders integration, a file shelf with AirDrop, a mirror, a charging indicator and a replacement for the volume, brightness and keyboard backlight HUDs. It is licensed GPL-3.0 and requires macOS 14 Sonoma or later.

How do I install Boring Notch on my Mac?

Either download the DMG from the latest release, open it and move Boring Notch to /Applications, or install the Homebrew cask with brew install --cask TheBoredTeam/boring-notch/boring-notch. The Homebrew route bypasses the macOS security warning automatically, according to the README.

Why is Boring Notch not opening?

The README states that because the project has no Apple Developer account, macOS reports the app as being from an unidentified developer on first launch. The recommended fix is to run xattr -dr com.apple.quarantine /Applications/boringNotch.app after moving the app to Applications, then open it normally.

How do I use Boring Notch on a Mac?

Launch the app, hover over the notch to expand it, and use the controls to manage music. Click the star in the menu bar to customize the notch. The README does not document a separate settings window or configuration file.

How do I access Boring Notch settings?

The README points to the star in the menu bar as the way to customize the notch. It does not describe any other settings entry point, and no configuration file path or command-line interface is documented.

How do I install Boring Notch on a MacBook?

The steps are the same as for any supported Mac: use the Homebrew cask command, or download the DMG, move the app to /Applications, and clear the quarantine attribute with the xattr command the README gives. The README states macOS 14 Sonoma or later and Apple Silicon or Intel hardware.

Official sources

  1. License: GPL-3.0
  2. Project website
  3. README
  4. Releases
  5. TheBoredTeam/boring.notch on GitHub
For maintainers

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.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/theboredteam-boring-notch.svg)](https://hysenlabs.com/projects/theboredteam-boring-notch)
Community notes

Community notes