navtoj / NotchBar

A macOS app for adding widgets around the notch.
GNU Affero General Public License v3.0
87 stars 3 forks source link
The NotchBar app icon.

NotchBar

NotchBar is a macOS app designed to utilize the empty space around the notch.

Before

After

Installation

Requirements: macOS 14.5 or later

  1. Download the NotchBar.zip from the Releases page.
  2. Unzip and drag the NotchBar.app to your Applications folder.
  3. Launch NotchBar from your Applications folder or Spotlight.

[!TIP]

Can't open NotchBar.app?

Use this quick workaround.
|Step 1|Step 2|Step 3| |:-|:-|:-| |Click `Show in Finder`|_Right_ Click `NotchBar.app` → Click `Open`|Again, Click `Open`| |Solution 1.0[^1]|Solution 1.1|Solution 1.2| #### If the `Show in Finder` button is not visible... Solution 2.0[^2] |Step 0| |:-| |Open `Terminal` → Run `chmod +x /Applications/NotchBar.app/Contents/MacOS/NotchBar`| |Solution 2.1|

[^1]: This popup appears because Apple requires a CAD $119 yearly subscription to remove it. [^2]: This popup appears because the macOS Archive Utility breaks file permissions for the executable within the .app bundle.

Usage

After launching NotchBar, it will automatically cover the notch area of your MacBook.

A sparkle icon will also be shown in the menu bar for important actions.

[!TIP]

Can't see the NotchBar?

It might be covered by the macOS menu bar.
**Option 1 —** Set **`Automatically hide and show the menu bar`** option to **`Always`** Menu Bar Setting
**Option 2 —** Set **`Displays have separate Spaces`** option to **`Off`** Spaces Setting

Widgets

View Examples
📊 System Monitor
CPU Memory Storage Battery Network
🎵 Media Playback
Artwork Artist Track
Dropdown Details Card w/ Controls
📱 Active App
Name Icon
more coming soon...

Structure

Widgets
├── Example
│   ├── PrimaryView.swift
│   └── SecondaryView.swift
└── WidgetView.swift
WidgetView(

    // Required – Always Visible in Notchbar

    primary: PrimaryView.init,

    // Optional – Dropdown Card on Tap/Hover

    secondary: SecondaryView.init
)

Development

Contributions are most welcome! Please feel free to submit a Pull Request.

Install Tuist

brew tap tuist/tuist
brew install --formula tuist

Clone Repository

git clone https://github.com/navtoj/NotchBar.git
cd NotchBar/src/

Install Dependencies

tuist install && tuist build

Launch Xcode (Optional)

tuist generate

License

This project is licensed under the AGPLv3 License.

Acknowledgments

Repo Stats

Repobeats Analytics Image

Star History Chart