FunNotch

Your MacBook notch, doing something.

Media, a drag-and-drop file shelf, clipboard history, focus sessions, daily notes, a timer and thirteen widgets — all in the space around the camera.

Download · funnotch.xyz · Install guide · Changelog

Free and open source. No account, no subscription, no telemetry.

---

What it does

• Home — a grid you compose yourself. Drag widgets in, resize them, and save layouts. Give a case its own screen: one for when media is playing, one for the minutes before a meeting, one for a focus session, one for charging.
• Weather — when nothing is playing, the panel shows the forecast as an animated pixel scene that changes with the weather: sun, rain onto a skyline, drifting snow, lightning.
• Media — now playing from any app — Music, Spotify, browsers, podcast apps, video players — with artwork, a live spectrum, and a progress bar you can drag to seek.
• Shelf — a drag-and-drop file shelf that opens to meet a drag already in flight. AirDrop and share straight off it; catches new screenshots and finished downloads on its own.
• Clipboard — searchable history with pinning, and entries that expire after 24 hours by default. Anything a password manager marks concealed is skipped and never recorded.
• Focus & Timer — focus sessions that block websites and apps, with Pomodoro cycles, a week chart and a streak; plus a countdown and a stopwatch with laps, all around one dial you drag round to set.
• Notes — a scratchpad that starts a new note each day and saves to your Desktop, with the old ones a menu away.
• Battery — charge level, and while charging the actual wattage, with the meter coloured and animated by state.
• Widgets — thirteen of them, any number either side of the camera.
• HUD — volume, brightness and keyboard backlight that replaces the system overlay rather than sitting beside it.
• No notch? Still works. On an external display it draws a floating pill in the same place, like the Dynamic Island.
• And — camera mirror, calendar and reminders, meeting-link detection, custom themes, automatic updates, a diagnostics screen, and two games: Breakout and Dino Run.

Also in the box

Install

Download the latest .dmg, drag FunNotch to Applications, and open it.

First launch. Builds are signed ad-hoc rather than with a paid Apple Developer certificate, so macOS will refuse the first open. Go to System Settings → Privacy & Security and click Open Anyway, or right-click the app in Applications and choose Open. After that it opens normally, and updates arrive in-app.

Full walkthrough: funnotch.xyz/install.

Building

No Xcode project — the app builds with swiftc directly.

./build.sh                       # debug build into build/
./build.sh --universal           # arm64 + x86_64
./build.sh --universal --package # ...and produce dist/*.dmg and dist/*.zip

Requires the Xcode command line tools. Everything under build/ and dist/ is generated and git-ignored.

Signing

Builds are signed ad-hoc by default, which is why macOS refuses the first launch. If you have a paid Apple Developer certificate:

./build.sh --universal --package \
  --sign "Developer ID Application: Your Name (TEAMID)" \
  --notarize your-notary-profile

Verifying a change

There is a self-test that drives the real window manager rather than mocking it — it opens and closes the notch, simulates drags, and checks the panel geometry.

build/FunNotch.app/Contents/MacOS/FunNotch --self-test

It needs a GUI session, so it will not run over plain SSH. There is also a preview renderer that writes every notch state to PNG, which is how the screenshots in this README are produced:

build/FunNotch.app/Contents/MacOS/FunNotch --render-preview /tmp/shots

And a diagnostics dump:

build/FunNotch.app/Contents/MacOS/FunNotch --diagnostics

Layout

Sources/
  App/          Lifecycle, status bar, self-test, preview renderer
  Core/         Settings, home-screen layout model, extensions, diagnostic log
  Managers/     Media, shelf, clipboard, focus, notes, timer, calendar,
                battery, weather, HUD, updates
  Settings/     The settings window and the home-screen editor
  Views/        The notch panel and everything drawn in it
Tools/
  MakeIcon.swift    Generates the app icon at build time
  fetch-sparkle.sh  Pins and verifies the Sparkle framework
  make-appcast.sh   Signs a release for the auto-updater

The marketing site at funnotch.xyz is deliberately not in this repo — it isn't part of the app, and it deploys separately.

Permissions it asks for

None are required; each one only enables the feature that needs it.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗