Skip to content

navtoj/NotchBar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.01 Solution 1.1 Solution 1.2

If the Show in Finder button is not visible...

Solution 2.02

Step 0
Open Terminal → Run chmod +x /Applications/NotchBar.app/Contents/MacOS/NotchBar
Solution 2.1

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.

Clone Repository

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

Install Dependencies

Don't have tuist installed?

Install Tuist

brew tap tuist/tuist
brew install --formula tuist
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

Footnotes

  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.

About

A macOS app for your MacBook notch.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Languages