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!
---
## Installation
**System Requirements:**
- macOS **14 Sonoma** or later
- Apple Silicon or Intel Mac
---
### Option 1: Download and Install Manually
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.
---
#### Recommended: Terminal (Always Works)
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:
```bash
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](https://brew.sh). The Homebrew installation automatically bypasses the macOS security warning described above.
```bash
brew install --cask TheBoredTeam/boring-notch/boring-notch
```
## Usage
- 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.
## ๐ Roadmap
- [x] Playback live activity ๐ง
- [x] Calendar integration ๐
- [x] Reminders integration โ๏ธ
- [x] Mirror ๐ท
- [x] Charging indicator and current percentage ๐
- [x] Customizable gesture control ๐๐ป
- [x] Shelf functionality with AirDrop ๐
- [x] Notch sizing customization, finetuning on different display sizes ๐ฅ๏ธ
- [x] 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) ๐
## Building from Source
### Prerequisites
- **macOS 15.6 or later**
- **Xcode 26 or later**
### Installation
1. **Clone the Repository**:
```bash
git clone https://github.com/TheBoredTeam/boring.notch.git
cd boring.notch
```
2. **Open the Project in Xcode**:
```bash
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](CONTRIBUTING.md) to learn how you can join the fun!
## Join our Discord Server
## Star History
## 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
- **[MediaRemoteAdapter](https://github.com/ungive/mediaremote-adapter)** โ An open-source project that allowed us to use the Now Playing source in macOS 15.4+
- **[NotchDrop](https://github.com/Lakr233/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](./THIRD_PARTY_LICENSES.md) file.
### Icon credits: [@maxtron95](https://github.com/maxtron95)
### Website credits: [@himanshhhhuv](https://github.com/himanshhhhuv)
- **SwiftUI**: For making us look like coding wizards.
- **You**: For being awesome and checking out **boring.notch**!
## Star History
