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 and more!

---

Installation

System Requirements:

• macOS 14 Sonoma or later
• Apple Silicon or Intel Mac

---

Important

We don't have an Apple Developer account yet. The application will show a popup on first launch that the app is from an unidentified developer.

1. Click OK to close the popup.
2. Open System Settings > Privacy & Security.
3. Scroll down and click Open Anyway next to the warning about the app.
4. Confirm your choice if prompted.

You only need to do this once.

Option 1: Download and Install Manually

---

Option 2: Install via Homebrew

You can also install the app using Homebrew:

brew install --cask TheBoredTeam/boring-notch/boring-notch --no-quarantine

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.

📋 Roadmap

• Playback live activity 🎧
• Calendar integration 📆
• Mirror 📷
• Charging indicator and current percentage 🔋
• Customizable gesture control 👆🏻
• Shelf functionality with AirDrop 📚
• Notch sizing customization, finetuning on different display sizes 🖥️
• Reminders integration ☑️
• Customizable Layout options 🛠️
• Extension system 🧩
• System HUD replacements (volume, brightness, backlight) 🎚️💡⌨️
• Notifications (under consideration) 🔔

Building from Source

Prerequisites

• macOS 14 or later: If you’re not on the latest macOS, we might need to send a search party.
• Xcode 16 or later: This is where the magic happens, so make sure it’s up-to-date.

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! Here’s how you can join the fun:

1. Fork the Repo: Click that shiny "Fork" button and make your own version.
2. Clone Your Fork:

   git clone https://github.com/{your-name}/boring.notch.git
   # Replace {your-name} with your GitHub username

3. Make sure to use dev branch as base.
4. Create a New Branch:

   git checkout -b feature/{your-feature-name}
   # Replace {your-feature-name} with a descriptive and concise name for your branch
   # It is best practice to use only alphanumeric characters, write words in lowercase
   # and seperate words with a single hyphen

5. Make Your Changes: Add that feature or fix that bug.
6. Commit Your Changes:

   git commit -m "insert descriptive message here"

7. Push to Your Fork:

   git push origin feature/{your-feature-name}
   # Remember to replace {your-feature-name} with the name you chose

8. Create a Pull Request: Head to the original repository and click on "New Pull Request." Fill in the required details, make sure the base branch is set to dev, and submit your PR. Let’s see what you’ve got!

Join our Discord Server

Star History

Buy us a coffee!

🎉 Acknowledgments

We would like to express our appreciation to the developers of NotchDrop, an open-source project that has been instrumental in developing the "Shelf" feature in Boring Notch. Special thanks to Lakr233 for their contributions to NotchDrop and to Hugo Persson for integrating it into our project.

Icon credits: @maxtron95

Website credits: @himanshhhhuv

• SwiftUI: For making us look like coding wizards.
• You: For being awesome and checking out boring.notch!