Skip to content

karadoganyi/boring.notch

ย 
ย 

Repository files navigation


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:

  • 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

Download for macOS


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.
  • Click the star in your menu bar to customize your notch to your heart's content.

๐Ÿ“‹ Roadmap

  • Playback live activity ๐ŸŽง
  • Calendar integration ๐Ÿ“†
  • Reminders integration โ˜‘๏ธ
  • Mirror ๐Ÿ“ท
  • Charging indicator and current percentage ๐Ÿ”‹
  • Customizable gesture control ๐Ÿ‘†๐Ÿป
  • Shelf functionality with AirDrop ๐Ÿ“š
  • Notch sizing customization, finetuning on different display sizes ๐Ÿ–ฅ๏ธ
  • 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 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! Read CONTRIBUTING.md to learn how you can join the fun!

Join our Discord Server

Join The Boring Server!

Star History

Star History Chart

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

  • MediaRemoteAdapter โ€“ An open-source project that allowed us to use the Now Playing source in macOS 15.4+
  • 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 file.

Icon credits: @maxtron95

Website credits: @himanshhhhuv

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

About

TheBoringNotch: Not so boring notch That Rocks ๐ŸŽธ๐ŸŽถ

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Swift 98.2%
  • Perl 1.1%
  • Other 0.7%