Skip to content

Open source · macOS · MIT

NotchDeck.

Your MacBook notch, as a live dashboard for your dev day.

Music with synced lyrics, your AI agents, dev servers, builds and system changes, a glance away under the camera, without leaving your editor.

01

Lyrics in time, right under the camera

Apple Music and Spotify with artwork, a scrubbable progress bar and transport controls. Time-synced lyrics scroll line by line, cached on your Mac.

  • Synced lyrics from LRCLIB, with a quiet fallback when a song has none
  • A slim banner when the track changes
  • Skip, pause and scrub without switching apps
02

Your dev server, inside the notch

Start a React Native dev server or any command you configure and watch its output in a real terminal view, with colors and progress lines that update in place. Type into it too.

  • Bundle progress, reload, dev menu and DevTools target picker
  • Several dev servers, one switcher per port
  • Your own command buttons, run through your login shell
03

Know when your agent needs you

Claude Code and Codex report thinking, running a tool, needing input or done through local hooks. Xcode, Gradle and command-line builds show progress and results.

  • Up to four icons beside the notch, most important first
  • A banner when an agent needs input or a build finishes
  • Gradle task counts, Xcode results and an ndrun wrapper for anything else
04

One place for every pop-up

Volume, brightness, battery, Wi-Fi and Bluetooth changes appear as notch banners, with a slider you can drag. Optionally replace the macOS volume and brightness pop-up altogether.

  • Draggable level slider in the banner
  • Microphone, camera, screen recording and download indicators
  • Changes show in the open notch too

Also in the notch

Home

Music, Devtools and agents side by side in one wide view.

Shelf

Drop files on the notch, drag them back out or AirDrop them.

Clipboard

Searchable history with previews for JSON, JWTs and colors.

Focus

A Pomodoro timer counting down beside the notch.

Gestures

Flick up to close, scroll sideways to switch tabs.

Any display

A floating capsule on screens without a notch, and a display picker.

Get it

Install

For Apple silicon and Intel Macs on macOS 14 or later. NotchDeck is free and runs on your Mac; agent hooks talk to a local server only.

Install with one command

Downloads the latest release, checks its checksum, replaces an older copy, clears the quarantine flag for this unsigned build and opens the app. Run it again to update.

curl -fsSL https://salomo.dev/notchdeck/install.sh | bash

Download the app

Get the DMG from the latest release. Builds are not signed, so approve the first launch in System Settings → Privacy & Security.

Latest release ↗

Build from source

Needs Xcode 15+ and XcodeGen. No third-party packages.

git clone https://github.com/salomohutapea/NotchDeck && cd NotchDeck && xcodegen generate
Build it with me

Contribute

NotchDeck is MIT licensed. Bug reports, ideas and pull requests are welcome.

  1. Open an issue

    Include your macOS version, your Mac model (notch or not) and the module involved.

    New issue ↗
  2. Read the architecture

    Each module is one folder with its own notes. Start from the module contract and the coordinator.

    Architecture notes ↗
  3. Open a pull request

    Describe the change and what you checked. CI builds the app and a DMG for every push.

    Pull requests ↗