Skip to content

marvin753/NotchX


NotchX
NotchX

Meet NotchX — a Dynamic Island-style interface for every MacBook with a notch. Instead of wasting that black cutout at the top of your screen, NotchX transforms it into an always-available command center: glanceable at a glance, expandable on demand, and completely out of your way when you don't need it.

Expand the notch to access Now Playing controls with a rich music visualizer, your upcoming Calendar events, a Shelf with AirDrop support, system HUD replacements for volume and brightness, a Focus Timer to keep you locked in, Bluetooth device management, a fullscreen Teleprompter mode, and more — all wrapped in a frosted-glass interface that feels like it belongs on macOS.

NotchX Demo


Installation

System Requirements:

  • macOS 14 Sonoma or later
  • MacBook with a built-in notch display
  • Apple Silicon or Intel Mac

Option 1: Download and Install Manually

Download for macOS

Once downloaded, open the .dmg and move NotchX to your /Applications folder.

Important

NotchX is currently unsigned, so macOS will show a security warning on first launch. This is expected — you only need to bypass it once.

Use one of the methods below to open the app.


Recommended: Terminal (Always Works)

After moving NotchX to your Applications folder, run:

xattr -cr /Applications/NotchX.app

Then open the app normally.


Alternative: System Settings

Note

This method doesn't work for all users. If it fails, use the Terminal method above.

  1. Control-click (right-click) on NotchX in your Applications folder and select Open.
  2. Click Open in the security dialog to confirm.

If the app was already blocked by a previous double-click:

  1. Open System SettingsPrivacy & Security.
  2. Scroll down and click Open Anyway next to the NotchX warning.
  3. Enter your password if prompted.

Option 2: Install via Homebrew

brew install --cask MarvinBarsal/notchx/notchx --no-quarantine

Usage

  • Launch NotchX — it runs silently in the background with no Dock icon or menu bar clutter.
  • Hover over the notch to expand it and reveal the full interface.
  • Click or two-finger swipe on the notch to toggle between modules.
  • Open Settings to configure modules, gestures, and visual preferences.

Building from Source

Prerequisites

  • macOS 14 or later
  • Xcode 16 or later

Steps

  1. Clone the repository:

    git clone https://github.com/MarvinBarsal/NotchX.git
    cd NotchX
  2. Open in Xcode:

    open NotchX.xcodeproj
  3. Build and run:
    Press Cmd + R or click the Run button.


🤝 Contributing

Contributions are welcome! Read CONTRIBUTING.md to get started.


Notable Projects

NotchX builds on the shoulders of some great open-source work:

For a full list of licenses and attributions, see THIRD_PARTY_LICENSES.md.

About

NotchX - macOS Notch Customization App

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages