boring.notch README

The project's README from github.com/TheBoredTeam/boring.notch. As one markdown file: README.md.


Boring Notch
Boring Notch

TheBoringNotch Build & Test Discord Badge Ko-Fi

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!

Demo GIF

Installation

System Requirements:

Option 1: Download and Install Manually

Download for macOS

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

Then open the app normally.

Alternative: System Settings

[!NOTE] This method doesn't work for all users. If this doesn't work, use the Terminal method above.

  1. Try to open the app — you'll see a security warning.
  2. Click OK to dismiss it.
  3. Open System Settings > Privacy & Security.
  4. Scroll to the bottom and click Open Anyway next to the Boring Notch warning.
  5. Confirm if prompted.

Option 2: Install via Homebrew

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

Usage

📋 Roadmap

Building from Source

Prerequisites

Installation

  1. Clone the Repository:

    git clone https://github.com/TheBoredTeam/boring.notch.git
cd boring.notch

  2. Open the Project in Xcode:

    open boringNotch.xcodeproj

  3. Build and Run:

    • Click the "Run" button or press Cmd + R. Watch the magic unfold!

🤝 Contributing

We’re all about good vibes and awesome contributions! Read CONTRIBUTING.md to learn how you can join the fun!

Join our Discord Server

Join The Boring Server!

Star History

TheBoredTeam/boring.notch GitHub star history

Support us on Ko-fi!

Support us on Ko-fi

🎉 Acknowledgments

We would like to express our gratitude to the authors and maintainers of the open-source projects that made this possible.

Notable Projects

For a full list of licenses and attributions, please see the Third-Party Licenses file.

Icon credits: @maxtron95

Website credits: @himanshhhhuv

boring.notch (TheBoredTeam/boring.notch)

Searching Database…

11.1K ·GitHub
Boring.notch
Что это такое?Boring Notch превращает вырез на вашем MacBook в динамический центр управления: он становится музыкальным плеером с живым визуализатором, интеграцией с календарём, полкой для файлов с поддержкой AirDrop и полной заменой всплывающих окон громкости, яркости и подсветки клавиатуры в macOS.
Как установить это на мой Mac?Скачайте .dmg из релизов, откройте его и перетащите Boring Notch в папку /Applications, или установите через Homebrew, что позволяет пропустить дополнительный шаг безопасности.
Какая версия macOS и какой Mac мне нужны?Нужна macOS 14 Sonoma или новее, приложение работает как на Mac с чипом Apple Silicon, так и на Mac с процессором Intel.
Заблокирует ли macOS запуск при первом открытии, ведь приложение не нотаризовано?Да: так как приложение не подписано учётной записью Apple Developer, macOS пометит его как созданное неизвестным разработчиком, и перед запуском придётся один раз обойти Gatekeeper через Терминал или Системные настройки.
Что делает вырез, когда я навожу на него курсор?При наведении вырез расширяется и показывает элементы управления музыкой, визуализатор, календарь, полку для файлов и другие виджеты, которыми он оснащён.
Можно ли настроить внешний вид и поведение выреза?Да, нажав на значок звезды в строке меню, вы откроете настройки, где можно изменить размер выреза, жесты и расположение элементов под ваш экран.
Какие функции пока находятся в планах?В планах Bluetooth-активности в реальном времени, интеграция с погодой, настраиваемые варианты расположения, виджеты на экране блокировки, система расширений и поддержка уведомлений.
What are similar projects?Sapphire, rooms, Ice, dimble, BetterDisplay, DockDoor, OpenYoink, macos-sysdata
Which topics is it in?menubar-app, calendar, widget, music-player, menu-bar, macos-app, homebrew, apple-silicon, swift, animation, customization, utility
Creator
TheBoredTeam
Size
7.1 MB
Stars
11.1K
Updated
CommitOct 18Releasev2.7.3Nov 24
Age
2y
Commits · 90 Days