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.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
