/boring.notch

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

Primary LanguageSwiftOtherNOASSERTION

TheBoringNotch

TheBoringNotch Build & Test

Download

Warning

We don't have Apple Developer account yet. The applications will show a popup on first start. Click Okay, then go to Settings / Privacy & Security and scroll down until you see a button Open anyway. You'll have to do this once.

Buy us coffee

Buy Me A Coffee

Join our Community on Discord

Discord - Human Action, HD Png Download@kindpng.com

Preview

BoringNotch.mp4

Welcome to Boring.Notch, the coolest way to make your MacBook's notch the star of the show! Forget about those boring status barsโ€”our notch turns into a dynamic music control center, complete with a snazzy visualizer and all the music controls you need. It's like having a mini concert right at the top of your screen!

Icon credits: @maxtron95

Website credits: @himanshhhhuv

โšก Under the Hood Improvements and New features ๐Ÿ› ๏ธ

  • Album Art Perfection: We've fixed the album art cropping issue, so your music looks as good as it sounds. ๐Ÿ–ผ๏ธ
  • Notch Behavior: The notch now behaves better. It only expands when you hover over it, and its size is consistent. ๐ŸŽฏ
  • Multi-Desktop Magic: Enjoy Boring Notch on all your desktops without a hitch. ๐Ÿ–ฅ๏ธ
  • Battery Buddy: Keep an eye on your battery level with a new charging animation. โšก
  • Music Madness: We've smoothed out the music layout for a better listening experience. ๐ŸŽถ
  • Macbook Air Love: Macbook Air users, rejoice! Boring Notch now supports you. ๐ŸŽ

๐Ÿš€ Getting Started

Prerequisites

  • A MacBook: With a boring notch.
  • macOS 14.2 or later: If youโ€™re not on the latest macOS, we might need to send a search party.
  • Xcode 15.0 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/iamharshdev/boring.notch.git
    cd boring.notch
  2. Open the Project in Xcode:

    open boringNotch.xcodeproj
  3. Build and Run:

    • Select your target device (MacBookโ€”you do have one, right?).
    • Click the "Run" button or press Cmd + R. Watch the magic unfold!

๐ŸŽธ 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

  • Proper notch sizing and animations ๐Ÿ“
  • Delayed notch opening โฒ๏ธ
  • Charging indicator and current percentage ๐Ÿ”‹
  • Playback live activity ๐ŸŽง
  • Calendar integration ๐Ÿ“† Coming soon
  • Clipboard history manager ๐Ÿ“Œ Coming soon
  • Customizable gesture control ๐Ÿ‘†๐Ÿป Coming soon
  • Customizable function buttons ๐ŸŽ›๏ธ Coming soon
  • Shelf functionality with AirDrop ๐Ÿ“š Coming soon
  • System HUD replacements (volume, brightness, backlight) ๐ŸŽš๏ธ๐Ÿ’กโŒจ๏ธ Coming soon
  • Download indicator of different browsers (Safari, Chromium browsers, Firefox) ๐ŸŒ Coming soon
  • Layout customization options ๐Ÿ› ๏ธ
  • Notch sizing customization, finetuning on different display sizes ๐Ÿ–ฅ๏ธ
  • App switcher ๐Ÿช„
  • Notifications (under consideration) ๐Ÿ””

๐Ÿค 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/iamharshdev/boring.notch.git
  3. Create a New Branch:
    git checkout -b feature/YourFeatureName
  4. Make Your Changes: Add that feature or fix that bug. Make sure itโ€™s awesome.
  5. Commit Your Changes:
    git commit -m "Added a super cool feature!"
  6. Push to Your Fork:
    git push origin feature/YourFeatureName
  7. Create a Pull Request: Head to the original repo and click "New Pull Request". Show us what youโ€™ve got!

๐Ÿ“ License

This work is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/4.0/.

๐ŸŽ‰ 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.

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