📈 GH Trending Explorer 🎲 Surprise me

← all repos

TheBoredTeam / boring.notch

git clone https://github.com/TheBoredTeam/boring.notch.git v2.7.3 · 11mo ago 🔥 on GitHub Trending today

TheBoringNotch: Not so boring notch That Rocks 🎸🎶

—
stars, 24h
—
stars, 7 days
+356
stars, 30 days · #742
11k
★ total
1.1k
forks · 406 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageSwift
LicenseGPL-3.0
Created2024-08-02 (2y ago)
Last pushtoday
Watchers55
OwnerOrganization

Seen on GitHub Trending

  • 2026-10-20 — #11 monthly in swift · +356 ★

Links

README excerpt
Boring Notch
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:
 [code] 
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.
 [code] 
## 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**:
 [code] 
2. **Open the Projec