Put your MacBook's
notch to work.

Music, system stats and coding agents in the wings beside the notch. When Claude Code or Codex is waiting on you, it says so.

Download for MacStar on GitHub

Free and open source, MIT · macOS 13+, Apple silicon · No notch? It floats under the menu bar.

QNotch runs on Windows and Mac. Send yourself the link and try it there.

This one is live. Hover over the notch.This one is live. Tap the notch.
localhost:3000/upload
Upload

Try a file upload here. Demo files stay in your browser.

Downloads
This PCalex Downloads
Drag a file onto the notch or into the browser. Double-click to preview.
Music
Terminal
Click to wake

Try Ctrl Alt N to open the panel, or type QNotch.exe notify "Hi" in the pwsh tab to send a demo notification.

Try ⌃ ⌥ N to open the panel, or type qnotch notify "Hi" in the zsh tab to send a demo notification.

QNotch for Mac

A free, open source notch app for your MacBook.

QNotch puts the space around your MacBook's notch to work. The wings beside the camera show what's playing in Music or Spotify, your system stats, the weather and your Claude Code and Codex sessions. Hover over the notch and a panel opens with clipboard history, a file tray, notes, search and more.

It's native Swift and AppKit, signed and notarized by Apple, and uses about 11 MB of memory while idle. No notch? On other Macs and on external displays it floats as a pill under the menu bar.

Runs on
Apple silicon Macs (M1 or newer) with macOS 13 Ventura or newer.
Download
QNotch-macos-arm64.dmg, 4 MB, signed with a Developer ID and notarized.
Updates
Built in, through Sparkle.
Permissions
None up front. macOS asks once before QNotch controls Music or Spotify.
Price
Free and open source under the MIT license. No account.
Also on
Windows 11 and 10, as a native WPF app.

11 MB of memory while idle.

Activity Monitor's Memory column on a MacBook Air (M2), every feature on, panel closed. It's native Swift and AppKit, not a browser in a trench coat.

  • <0.01%of one core, idle
  • 11 MBof memory, idle
  • 4 MBdownload, native AppKit
  • 0disabled extensions loaded
Features

Hover to open
your tools.

Clipboard history, agent sessions and everything below, one hover away. Don't need something? Switch it off in Settings and QNotch won't even load it.

Rate limit the upload endpointapi · Claude needs your permission to use Bash
$2.14
Upload form in the new designweb · Working for 6m4 processes · 484 MB · :3000
$1.72
Fix the flaky checkout testCodex · shop · Working for 2m
node astro.mjs devLeft running · 210 MB · :4321

See when an agent is waiting on you.

I kept coming back to terminals that had been sitting on a yes/no question for 20 minutes, so I built this. The pill shows every Claude Code and Codex session by title and status. When one needs you, it widens and plays a sound.The notch shows every Claude Code and Codex session by title and status. When one needs you, its wings say so and it plays a sound. Click it and you're straight back in that session.

See today's token usage for each Claude Code session. Check the dev servers a session left running and stop them with a button.

QNotch.exeqnotch notify "Build finished" "142 tests passed" --level success
Build finished142 tests passed

Send notifications from scripts.

Post through the command line, a named pipea Unix socket or local HTTP. Add buttons and wait for the user's answer.

Midnight CityM83

Control your music.

See the track and artwork. Pause or skip media playing in Spotify, your browser or another media app.

See the track and artwork, seek, pause or skip in Music and Spotify, without switching apps.

github.com/Somafet/qnotch
dotnet build -c Releaseswift build -c release
#5B9DFF

Find something you copied.

Keep a history of copied text, code, links and images. Pin entries to keep them. History stays in memory unless you choose to save it. Passwords your password manager marks as concealed never get in.

Midnight City · M83 CPU 13%GPU 61% 71°CRAM 21.2/31.9 GB21:09
CPU 13%GPU 61%RAM 68%21:09

Keep stats visible during games.

When a game or fullscreen video is running, QNotch shrinks to one status line, ignores hover and lets clicks straight through. Missed shots are on you now.

When a game is in front, the notch steps aside: the panel stays shut, clicks pass through and the wings show only the stats you pick. Missed shots are on you now.

Ends in 14 minPhone connected.
screenshot-0927.pngSent
IMG_2044.jpgSaved to Downloads\QNotch

Send files to your phone and back.

Scan the code and your phone's browser can grab files from the tray or send photos back to Downloads\QNotch. No app, no account.

Fair warning: it's plain HTTP over your local network, not encrypted, and the link dies after 15 minutes unless you extend it.

screenshot-0927.png471 KB · Downloads
invoice-0925.pdf86 KB · Downloads
wallpaper-bloom.jpg2.2 MB · Pictures

Keep files within reach.

Drop files on the notch and they wait on the Files tab: Quick Look with Space, drag them out, or Share to send them over AirDrop.

QNotch keeps references, not copies, and follows a file when you rename or move it.

In a callCPU 9%10:02
CPU 9%Zoom

See when apps use your mic or camera.

The pill shows an icon while an app uses your microphone or camera. QNotch silences notification alerts during calls.

An orange mic and a green camera show in the wing while an app uses them, with the app's name on macOS 14.2 or newer. QNotch silences notification alerts during calls.

Claude Code · 5h62%
Codex · week28%
2 banked resets · next expires in 5 days

Launch AI apps with a shortcut.

Use Alt 1 through Alt 6⌃ ⌥ 1 through ⌃ ⌥ 6 to launch your AI apps. Check Claude Code and Codex usage limits and your remaining banked resets.

14°Partly cloudy
Oslo · Feels 12° · 4 m/s
TodayPartly cloudy15° 8°
FriLight rain showers12° 7°
SatCloudy11° 6°
SunClear sky16° 7°

Check the weather.

Pick your town and get the yr.no forecast: right now and the next three days on Home, plus the temperature in the pill and the game barbeside the notch. No account or API key, and no location access.

More tools and settings.

  • Note
  • GitHub graph
  • File tray
  • Volume
  • Timer
  • Color picker
  • Scheduled tasks
  • Launch agents

Drag the pill sideways or onto another display. QNotch remembers its position for each app. In Edit mode, drag Home cards and tabs to reorder them.

Choose an audio file for each alert. Copy your appearance, layout and shortcut settings as a setup code to use on another PC, Windows or Mac.

Pause, resume or delete your own launch agents from the Scheduled tab. In Edit mode, drag Home cards and tabs to reorder them. No notch? Drag the floating pill sideways and it remembers the spot for each display.

Pick a system sound or an audio file for each alert. Copy your layout and settings as a setup code to use on another Mac, or on Windows.

Hotkeys

Open the panel with a shortcut.

Use these shortcuts from any app. Change them in Settings, Hotkeys, or try them in the demo above.

  • ⌃⌥NOpen or close the panel
  • ⌃⌥FSearch
  • ⌃⌥GGame mode: Automatic, On, Off
  • ⌃⌥1-6Launch the AI app in that slot
  • EscClose the panel
Open source · MIT

Add your own extension.

QNotch is a shell and sixteen extensions, each in one folder. An extension you turn off is never loaded. Yours can show up in five places.

QNotch is a shell and fifteen extensions, each in one folder. An extension you turn off stops right away. Yours can show up in five places.

  • CardsA tile on the Home grid
  • TabsA page in the panel
  • SegmentsThe pill, the glance strip, the game barThe wings beside the notch
  • Search sourcesResults in the one search box
  • SettingsIts own settings page
Privacy

Your content stays on your device.

Your content stays local. QNotch shares usage actions with PostHog by default, without your content. Turn off Share usage data in Settings, General or set QNOTCH_TELEMETRY_ENABLED=false. The privacy policy has the details.

  • Local settings and notes

    Settings, notes and logs live in ~/Library/Application Support/QNotch.Mac. You do not need an account.

  • Tokens in the Keychain

    QNotch stores your GitHub and notification tokens in the macOS Keychain, never in a file.

  • Clipboard history in memory

    QNotch keeps clipboard history in memory unless you choose to save it, and skips what password managers mark as concealed.

  • Online features and usage data

    Online integrations are optional. Usage events include hashed account or installation identifiers, never notes, clipboard text or file contents.

Questions

Common questions.

For other questions, ask on GitHub.

Is it free?

Yes. QNotch is free under the MIT license, on Windows and Mac. It needs no account or subscription. The source is on GitHub.

How is QNotch different from other Mac notch apps?

It is free and MIT licensed, it shows your Claude Code and Codex sessions beside the notch, and the same app runs on Windows: a setup code moves your layout between the two.

Which Macs does it run on?

Apple silicon Macs (M1 or newer) with macOS 13 Ventura or newer. There is no Intel build.

Is the Mac app signed?

Yes. It is signed with a Developer ID and notarized by Apple, so it opens like any other app. Updates come through Sparkle, which installs only a copy signed the same way.

Does my Mac need a notch?

No. On a Mac or an external display without one, QNotch is a floating pill under the menu bar. Drag it sideways and it snaps to the center or an edge, and remembers the spot for each display.

Which permissions does it ask for?

None up front: no Accessibility, Screen Recording or notification permission. macOS asks once before QNotch controls Music or Spotify, and on macOS 15.4 or newer it may ask once whether QNotch can read the clipboard.

Why does Now playing only show Music and Spotify?

macOS has no public way to read other apps' media sessions, and QNotch doesn't use private frameworks. Music and Spotify announce their tracks publicly and accept remote controls.

Does it get in the way of full-screen games on a Mac?

No. When a game is in front, the notch steps aside: the panel stays shut, clicks pass through and the wings show only the stats you pick. ⌃⌥G switches between Automatic, On and Off.

How does the Agents tab know what Claude Code and Codex are doing?

One click in Settings, Agents adds a hook to Claude Code's settings.json or Codex's hooks.json, with a backup. Codex then asks you to trust it once. The hook talks to QNotch over a local pipe on Windows or a Unix socket on the Mac. Token counts come from the transcripts Claude Code already keeps on your computer.

Where does the button on an agent take me?

It opens that session or thread in the Claude or Codex app. For a terminal session, it brings the terminal to the front.

Is the cost what I am billed?

No. It's what those tokens would cost at API list prices. Pro and Max plans don't bill per token, so think of it as a 'look how much I'm getting out of my plan' number, not your bill.

Can I use it on an external display?

Yes. Pick the main display or a specific one in Settings, General. If that display disconnects, QNotch moves to the main display and comes back when you reconnect it.

Can I move my settings between Windows and Mac?

Yes. Settings, General, Share your setup copies a code with your layout, features and preferences. Paste it into QNotch on the other computer, on either platform. Accounts, tokens and history never leave.

How do I add a feature of my own?

Open an issue with a sentence on what it does and where it shows, then build it in its own folder: src/QNotch/Modules on Windows, src/QNotch.Mac/Sources/QNotchMac/Modules on the Mac. The contributing guide walks through it.

Try QNotch on
your Mac.

I built QNotch for Windows because the nice notch apps were Mac only. Then I wanted it on my MacBook too, so I rebuilt it natively in Swift.

Download for MacView the source

Free and open source · MIT license · Also on Windows

Other ways to install

The same files as the Download button, straight from GitHub.

These are all free. If QNotch is useful to you, consider sponsoring its development.

Sponsor on GitHub
Download ZIP