Turn your MacBook’s notch into a beautifully functional and customizable space.

• 🎥 Live Demo
• 📦 Download
• 📖 About
• 🎉 Features
• ⚙️ Metal Animations
• ⚠️ Known Issues
• ✅ Planned Features & Improvements
• 📦 Build From Source

Volume/Brightness Controls

Messages

✨ Watch ComfyNotch bring your MacBook’s notch to life ✨

⚠️ Note: This video shows a recent build, but ComfyNotch is under active development —
features and visuals might look a little different in your download!

⚠️ Not on the App Store (yet) — but super easy to run!

1. Go to the Releases tab
2. Download the latest .zip file (e.g. ComfyNotch-v0.1.0.zip)
3. Double-click to open it

🧠 Why?
I have a Developer ID, but I’m skipping the whole notarization + App Store process for now.
macOS will warn you it’s “unverified,” but it’s totally safe — just follow the steps above ....

ComfyNotch brings life to your MacBook’s notch by providing a clean and intuitive way to interact with widgets and other functionalities. It’s all about making your Mac feel comfy and stylish.

• ✅ Widgets: AI Integration, Music Player, Camera Widget, Notes, Time Display, and more!
• 🤖 AI Chat: Seamlessly interact with powerful AI models like OpenAI's GPT-4 directly from your notch
• 🎵 Music Control: Easily control your music playback with slick visual indicators.
• 📋 Clipboard Manager: Keep track of your recent copies like a pro.
• 🗂️ File Tray: Access your files directly from the notch.
• 📅 Apple Calendar Integration: View your events and reminders directly from your notch
• 📝 Notes Widget: Keep quick notes accessible from the notch.
• ⏰ Time Widget: Always know the time with style.
• 🔄 Smooth Animations: Every interaction feels satisfying.
• 📷 Camera: See how your looking in public
• 🎨 Coming Soon: Customization: Easily add your own widgets.

Hold down a modifier key (e.g. ⌘ or ⌥) and hover near the notch —
ComfyNotch will temporarily hide itself so you can access toolbar elements underneath.

Currently Not Working (cuz I reworked everything and wanna get a actual swiftpm to manage this)

Perfect for apps with chunky UIs like Xcode, Finder, or Final Cut.

🔥 Pretty sure no other notch utility does this.

🔗 View Metal Animation Demo v0.1.23

1. macOS Compatibility
   • ⚠️ Volume controls don’t work reliably on all macOS versions — avoid using them unless you really dislike the default OSD (OSDUIHelper).
   • ComfyNotch only supports macOS 14 (Sonoma) and above.
   • ComfyNotch also uses Metal for rendering, which is not available on macOS 13 and below.
   • Users on macOS 13 and below may experience crashes or missing functionalities.
   • No plans for backward compatibility, but feel free to open an issue if needed.

• App Restart on Display Changes: Automatically restart the app when monitors are plugged in or unplugged.
• Hide App Icon: Hide app icon at all times, no need to bother the users dock.
• Album View When Closed: Display album art in a mini view when the panel is closed.
• Music Playing Indicator: Add a smooth icon animation to indicate when music is playing.
• Multiple Notes System: Implement a notes dashboard with multiple notes accessible through tabs.
• Dynamic Animated Button Colors: Match the animated buttons’ colors to the dominant color of the album art.
• AI Chat Integration (More Coming Soon...): Allow users to interact with an AI chat feature by providing their own API keys.
• Clipboard Manager: Implement a clipboard manager to keep track of copied items.
• Pomodoro Timer: Add a Pomodoro timer to help users manage their time effectively.
• Notifications Popup: Right now there is a hover on the notch that pops down i'm sure we can reuse that for notifications
• Better Shortcut Management: Implement a better shortcut management system to allow users to customize their shortcuts easily.
• File Tray: Add a file tray to allow users to access their files easily.

git clone https://github.com/YourUsername/ComfyNotch.git
cd ComfyNotch
open ComfyNotch.xcodeproj

• Open the project in Xcode

• Select the target ComfyNotch in the project navigator

• Build the project (Cmd + B)

• Run the project (Cmd + R)

• Note: You may need to set up your signing certificate in Xcode.

• Products > Archive > Distribute App > Developer ID

🛠️ Note: Building from source may require additional dependencies.
Currently, I'm using a local copy of some modules until they're finalized — including
ComfyCalendar