lo-cafe / nootch-oc

### 🌈 𝗣 𝗔 𝗧 𝗥 𝗢 𝗡 　 𝗠 𝗘 　 𝗙 𝗢 𝗥 　 𝗚 𝗢 𝗗 ' 𝗦 　 𝗦 𝗔 𝗞 𝗘 🌈
**🟥🟧🟨🟩🟦🟪 ⟪ 𝒾 𝒹𝑒𝓈𝑒𝓇𝓋𝑒 𝓈𝑜𝓂𝑒 𝒻𝓇𝑒𝒶𝓀𝒾𝓃𝑔 𝓅𝑒𝓃𝓃𝒾𝑒𝓈 ⟫ 🟪🟦🟩🟨🟧🟥**
`░▒▓█`   ⓣⓗⓘⓢ ⓐⓟⓟ ⓘⓢ ⓕⓡⓔⓔ · ⓣⓗⓔ ⓓⓔⓥ ⓘⓢ ⓝⓞⓣ   `█▓▒░`
🪙 💸 🪙 💰 🪙 💸 🪙 💰 🪙 💸 🪙 💰 🪙 💸 🪙
**→ 𝚙𝚊𝚝𝚛𝚎𝚘𝚗.𝚌𝚘𝚖/𝚕𝚘𝚏𝚒𝚌𝚊𝚏𝚎 ←**
 every single penny keeps the notch alive. no pressure. (lots of pressure.) 
---
# NotchNook
**Your MacBook notch is a black rectangle doing nothing. NotchNook gives it a job.**
> [!TIP]
> ### 🚀 Meet Nootch, the successor
> **Nootch** is NotchNook's commercial and spiritual successor. If you just want a polished notch app that keeps getting updates, get it at **lo.fi/nootch**.
> This repo stays here as the open-source original, for tinkering, learning, and building for yourself.
---
## ✨ What it does
NotchNook draws an interactive UI around the MacBook notch. Hover over it and **the Nook** expands into a strip of widgets:
| | Widget | |
|---|---|---|
| 🎵 | **Media Player** | Now playing, album art, and playback controls for any media source |
| 📅 | **Calendar** | Upcoming events with a smooth, scrollable day strip |
| 📝 | **Notes** | Rich-text notes, right in the notch |
| ✅ | **Todos** | A quick checklist that stays out of the way |
| ⏱️ | **Timer** | Scroll-wheel timer with haptics and a Liquid Glass pill |
| 🪞 | **Mirror** | A one-tap camera mirror before that call |
| ⚡ | **Shortcuts** | Run your macOS Shortcuts from the notch |
It also has:
- 📥 **The Tray**: drag files onto the notch to park them, then drag them out later.
- 🎯 **Drop area**: a target for files in transit.
- 🔴 **Live activities**: battery, Bluetooth, and media indicators next to the notch.
- 🖥️ **Multi-display support**: one notch per screen, rebuilt on the fly when displays change.
- 🌍 **Localization**, crowdsourced through Crowdin.
## 🛠️ Building from source
**Requirements:** macOS 14.4+, Xcode with the macOS 26 SDK (for the Liquid Glass code paths).
 [code] 
Xcode resolves every Swift package on first open. Select the `NotchNook` scheme and press **Run**.
### Build variants
| Variant | How | Notes |
|---|---|---|
| **Standalone** | Default `Debug` / `Release` | Uses Sparkle for auto-updates |
| **Setapp** | `SETAPP_BUILD` compilation condition | No Sparkle; uses Setapp licensing |
Code that touches updates, licensing, or the About screen needs to compile under **both** variants (`#if !SETAPP_BUILD`).
Release tooling (signing, notarization, appcast) lives in `scripts/`. You'll need your own Developer ID certificate.
## 🧠 Architecture, briefly
- **AppKit-hosted, SwiftUI-rendered.** `WindowsManager` owns one borderless, transparent window per screen. Each window roots a `RootView` → `NotchView`.
- **Settings live in `Defaults`.** Each settings group is one `Codable` struct in `extensions/Defaults.swift`. `RootView` injects every group into the SwiftUI environment.
- **Widget data** (notes, todos) is stored with **SwiftData** in one shared `ModelContainer`.
- **Widgets** sit on a 50pt grid (`NookGrid`) under `components/Notch/Nook/Widgets/`.
- **Liquid Glass**