Skip to content
NotchDeck

v1.1.0 · Open source · macOS 14+

Your notch, now a live dev dashboard.

NotchDeck turns the MacBook notch into a quiet status surface for developers. Music with synced lyrics, your AI agents, dev servers, builds and system changes, a glance away, without leaving your editor.

curl -fsSL https://salomo.dev/notchdeck/install.sh | bash
  • Modules10, each optional
  • AgentsClaude Code · Codex
  • BuildsXcode · Gradle · ndrun
  • LicenseMIT · runs locally

Music & lyrics

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

Devtools

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

Agents & builds

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

System

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

Small things you reach for all day

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.

Install

Get NotchDeck

Free for Apple silicon and Intel Macs on macOS 14 or later. Everything runs on your Mac; hooks talk to a local server only.

Install or update with one command

Downloads the latest release, checks it against its published checksum, replaces an older copy, clears the quarantine flag for this unsigned build and opens the app. Installs to ~/Applications on accounts that cannot write to /Applications.

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

Download the app

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

Latest release · v1.1.0 ↗

Build from source

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

git clone https://github.com/salomohutapea/NotchDeck && cd NotchDeck && xcodegen generate

Contribute

Open source, MIT licensed

Bug reports, ideas and pull requests are welcome. Most of the UI was built without much hands-on testing, so reports from real setups help a lot.

  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 ↗