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…

这是什么?Boring Notch 能把你 MacBook 的刘海变成一个动态控制中心:它可以变成带实时可视化效果的音乐播放器,支持日历集成、带 AirDrop 功能的文件暂存架,还能完全替代 macOS 的音量、亮度和键盘背光提示浮层。
我该怎么在 Mac 上安装它?从 releases 页面下载 .dmg 文件,打开后把 Boring Notch 拖进 /Applications 文件夹;也可以通过 Homebrew 安装,这样就不需要多做额外的安全设置步骤。
我需要什么版本的 macOS 和什么样的 Mac?需要 macOS 14 Sonoma 或更高版本,可以在 Apple Silicon 或 Intel 芯片的 Mac 上运行。
因为没有经过公证,首次启动时 macOS 会阻止它吗?会的。由于该应用没有使用 Apple 开发者账号签名,macOS 会将它标记为来自身份不明的开发者,你需要通过“终端”或“系统设置”绕过一次 Gatekeeper,之后才能打开。
鼠标悬停在刘海上会发生什么?悬停时刘海会展开,显示其中包含的音乐控制、可视化效果、日历、文件暂存架以及其他小组件。
我能自定义刘海的外观和行为吗?可以。点击菜单栏中的星星图标即可打开设置,你可以调整刘海的尺寸、手势和布局,使其适配你的显示器。
路线图上还有哪些功能尚未实现?计划中的新增功能包括蓝牙实时活动、天气集成、可自定义的布局选项、锁屏小组件、扩展系统以及通知支持。
Size
7.1 MB
Stars
11.1K
Age
2y
Commits · 90 Days