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.
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
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
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
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.
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 | bashDownload 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 generateContribute
NotchDeck is MIT licensed. Bug reports, ideas and pull requests are welcome.
Open an issue
Include your macOS version, your Mac model (notch or not) and the module involved.
New issue ↗Read the architecture
Each module is one folder with its own notes. Start from the module contract and the coordinator.
Architecture notes ↗Open a pull request
Describe the change and what you checked. CI builds the app and a DMG for every push.
Pull requests ↗