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
- GitHub: github.com/TheBoredTeam/boring.notch
- Homepage: https://theboring.name/
- Releases · Issues · Hacker News mentions
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