🚀 ComfyNotch

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

📚 Table of Contents

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

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

⚠️ Note: This video shows a old build, Honestly, I kinda hate recording demos — there’s too much to show and it never captures everything.
ComfyNotch is under active development, so the features and visuals in your download might look a bit different!

📦 Download

⚠️ Not on the App Store - Not Planning on it being on the App Store — 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 …

…or build it yourself from source.

📖 About

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.

---

🎉 Features

• ✅ 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.

🪄 Smart Notch Hiding (You’ve never seen this before)

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.

Live Demo 🎥

https://github.com/user-attachments/assets/03f213db-cb36-4a2b-92c2-c580f07ed741

Volume/Brightness Controls

Messages

FileTray

with Everything that can go wrong

Notch Width Change

https://github.com/user-attachments/assets/49be94da-219a-44f1-84e6-2b6b693b73aa

⚙️ Metal Animations

🔗 View Metal Animation Demo v0.1.23

⚠️ Known Issues

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.0 and above

---

✅ Planned Features & Improvements

🔧 Functionality Enhancements

• [x] App Restart on Display Changes: Automatically restart the app when monitors are plugged in or unplugged.
• [x] Hide App Icon: Hide app icon at all times, no need to bother the users dock.
• [x] Album View When Closed: Display album art in a mini view when the panel is closed.
• [x] Music Playing Indicator: Add a smooth icon animation to indicate when music is playing.
• [x] Multiple Notes System: Implement a notes dashboard with multiple notes accessible through tabs.
• [x] Dynamic Animated Button Colors: Match the animated buttons’ colors to the dominant color of the album art.
• [x] AI Chat Integration (More Coming Soon…): Allow users to interact with an AI chat feature by providing their own API keys.
• [x] 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.
• [x] File Tray: Add a file tray to allow users to access their files easily.

---

📦 Build From Source

💻 Clone and Build

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