GravityNotch
Health Uyari
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Basarisiz
- rm -rf — Recursive force deletion command in Configuration/dmg/build_release_dmg.sh
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Turn your MacBook notch into a Dynamic Island: AirPods Live Activity, macOS Tahoe HUDs, lock screen player with synced lyrics, screen OCR, clipboard history and live Claude Code agent tracking. Free and open source (GPL-3.0).
![]()
GravityNotch
Turn your MacBook notch into a Dynamic Island.
Free and open source. System HUDs that work on macOS 26 Tahoe, a lock screen music player with synced lyrics,
and live Claude Code / Codex agent tracking, right in the notch.
⬇️ Download the DMG · 🌐 Website & demos · 🤝 Good first issues
Credits (GPL-3.0): GravityNotch is an enhanced fork of TheBoredTeam/boring.notch, distributed under the GNU General Public License v3.0. All credit for the original architecture and codebase goes to the Boring Notch authors.
⬇️ Download for macOS
Download GravityNotch.dmg (macOS 14 Sonoma or later · Apple Silicon and Intel)
Or install with Homebrew, launch the app once, then follow steps 2 and 3 below:
brew install --cask adrielakak/tap/gravitynotch
- Open
GravityNotch.dmg, drag GravityNotch into the Applications folder, launch it once, and dismiss the macOS warning (Done). - Open System Settings > Privacy & Security, scroll all the way down to the Security section, click Open Anyway, and confirm.
- Follow the startup guide to grant Accessibility permission (required to display volume and brightness HUDs in the notch).
If Open Anyway does not appear, run this command in Terminal and reopen the app:
xattr -cr /Applications/GravityNotch.app
All releases are available on the Releases page. Starting with v1.2.6, built-in Sparkle updates check and install new versions automatically from GitHub.
✨ What's New in GravityNotch
1. 🔒 Lock Screen Media Player & Synced Lyrics (SkyLightWindow)
- Frosted glass lock screen panel, rendered above the macOS lock screen via
SkyLight. - Full playback controls: interactive scrub bar, previous/restart track, play/pause, next track, and
CoreAudiooutput switcher. - Live synced lyrics: dimmed previous line, glowing active line, and next line via LRCLIB (with automatic cleanup of
(Slowed)/(Remix)suffixes) or embedded Apple Music lyrics. Click any line to jump to that timestamp. - Animated artwork wallpaper (Apple Music only): when a track has Apple Music motion artwork, it fills the lock screen automatically on lock (cached locally per album to avoid flicker across tracks). Static artwork enlarges cleanly inside the player on tap.
- Smart idle hiding: automatically stays hidden when no music is loaded or the player app has quit, while remaining visible whenever a track is paused.
- Optional ambient glow and per-feature toggles in Preferences.
2. 🎵 Playing Next (Interactive Queue)
music.note.listbutton built directly into the music player controls.- Seamless toggle in the Home tab between your Calendar and the Playing Next queue.
- Click any upcoming track to play it immediately, or use
arrow.up.to.lineto promote it to the top of the queue. - Also works when streaming from the Apple Music catalog (reads the album tracklist) and warns when Shuffle hides the actual order.
3. 🔆 macOS Tahoe System HUDs
- Replaces the macOS system HUDs (Volume, Display Brightness, Keyboard Backlight, and Caps Lock HUD) with smooth animations inside the notch.
- Compatible with macOS 26 Tahoe: intercepts hardware media keys via
.cghidEventTap,.cgSessionEventTap, and.cgAnnotatedSessionEventTapon a.userInteractivequeue, readingCGEventfields (99and149) with zero latency or duplicate system popups.
4. 🔍 Text Capture (Screen OCR) & Element Capture
text.viewfinderbutton in the notch header:- Left-click: select any region of the screen and extract text straight to your clipboard via Apple Vision (
VNRecognizeTextRequest). - Right-click: capture a region or window/element directly into the Shelf.
- Left-click: select any region of the screen and extract text straight to your clipboard via Apple Vision (
5. 📋 Clips Tab (Clipboard History Manager)
- Live monitoring of
NSPasteboard.general(text, links, files, and hex color codes with live color swatches). - Instant search, pinning, one-click copy, and send-to-Shelf actions.
6. ✨ Agents Tab (Claude Code, Codex CLI & Antigravity Live Tracking)
- Real-time local monitoring of AI coding agent sessions from their transcripts (
~/.claude/projects,~/.codex/sessions, Antigravity):- Context / Quota gauge (
input_tokens + cache_read_tokens), Cache Hit %, generated tokens (output_tokens), and step counter (Step #). - Progress checklist, edited file pills with diff counts, and Live Tool Feed.
- Animated pixel mascots reflecting each agent's live state (working, waiting, idle).
- Context / Quota gauge (
- Keeps sessions active during long-running commands or silent thinking (up to 10 min mid-turn) and returns to the live session automatically 2 min after manual selection.
- Live Activity on the closed notch plus a status popover when an agent finishes or needs input.
7. ☕ Caffeine, 🎧 Audio Output & ⚡ Shelf Quick Actions
- Caffeine (
IOKitPower Assertion): keep your Mac awake (indefinitely, 15 min, 30 min, 1 h, or 2 h) directly from the notch header. - Audio Output Switcher (
CoreAudio): switch between MacBook speakers, AirPods, or external displays in one click. - Shelf Quick Actions: OCR on dropped images, ZIP compression, PNG conversion, background removal (BG via
VNGenerateForegroundInstanceMaskRequest), and instant file sharing via0x0.st.
🛠️ Building from Source
Requirements
- macOS 14 Sonoma, macOS 15 Sequoia, or macOS 26 Tahoe
- Xcode 16+
Build
xcodebuild -project boringNotch.xcodeproj -scheme boringNotch -configuration Debug \
CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO DEVELOPMENT_TEAM="" build
If xcodebuild reports that Command Line Tools are selected instead of Xcode, prefix the command with DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer.
Package a Release DMG & Update Appcast
./Configuration/dmg/build_release_dmg.sh
This builds the Release target, packages build/GravityNotch.dmg, signs it with Sparkle EdDSA, and updates docs/appcast.xml.
🌐 Website
The project landing page lives in docs/ (static HTML/CSS/JS served via GitHub Pages): adrielakak.github.io/GravityNotch.
🤝 Contributing & Roadmap
- See
ROADMAP.mdfor upcoming Live Activities, planned bugfix batches, and feature ideas. - Contributions are welcome, from first-timers too. Start with an issue labeled
good first issue, and readCONTRIBUTING.mdbefore opening a pull request (it explains one Xcode project quirk that will save you time).
📄 License & Acknowledgments
- Distributed under the GNU General Public License v3.0, see
LICENSE. - Forked from TheBoredTeam/boring.notch.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi