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.
Why is it paid on the Microsoft Store?
The Store copy is the same app. Buying it is an easy way to support development, and in return Windows installs it without a SmartScreen warning and the Store keeps it up to date. The download, winget, Scoop and Chocolatey stay free. Store and downloaded copies keep separate settings.
Do I need a laptop with a notch?
No. Windows laptops don't have one, so QNotch draws its own: a small pill at the top center of the screen. It works the same on a desktop monitor.
Is QNotch a Dynamic Island for Windows?
In spirit, yes. Like the Dynamic Island on an iPhone, the pill stays small, shows live activity such as music and your coding agents, and opens up when you hover over it. QNotch is an independent app, not made by Apple.
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.
Windows says "Windows protected your PC". Is that normal?
Yep, for now. The exe isn't code-signed yet, so SmartScreen has no clue who I am. Click More info, then Run anyway. Or if you'd rather not run a random exe from the internet (fair), get it from the Microsoft Store, which installs without the warning, or build it from source with the .NET 10 SDK.
Which download do I need?
QNotch-self-contained.zip (80 MB) runs as is. QNotch.exe (27 MB) is smaller but needs the .NET 10 Desktop Runtime.
Does it work on Windows 10?
Yes. It needs Windows 10 version 2004 or newer, on x64.
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.
Will it get in the way of my games?
No. When a game or fullscreen video is in front, Game mode shrinks the notch to one line of status, turns off hover and lets clicks pass straight through. Ctrl+Alt+G cycles Auto, On and Off.
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 put it on my other monitor?
Yes. Drag the pill onto it, or pick the monitor in Settings, General. It follows DPI changes without a restart.
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.