# Notchify — Comprehensive AI & LLM Technical Reference

Notchify is an open-source macOS utility developed by Christian Saguirre and inspired by Nadiane. It optimizes the physical notch on modern Apple MacBook Pro and MacBook Air laptops by turning the empty screen bezel into an interactive drawer and Dynamic Island.

## General Information
- Application Name: Notchify (formerly Nook)
- Bundle Identifier: dev.notchy.Notchify / com.christian.Notchify
- Latest Release: v1.0.0 / v1.2.0
- Repository: https://github.com/chrischancode/notchify
- Website: https://www.notchify.online
- License: MIT License (Free and Open Source)
- Primary Distribution: Apple Disk Image (.dmg) and ZIP archive (.zip)

## System Requirements & Compatibility
- macOS Version: macOS 13.0 (Ventura), macOS 14.0 (Sonoma), macOS 15.0 (Sequoia) or later.
- Hardware: MacBook Pro (14" & 16" with hardware notch, M1/M2/M3/M4 chips), MacBook Air (13" & 15" with hardware notch, M2/M3 chips).
- Non-notch Macs: Also compatible with notch-less displays, where it creates a virtual Dynamic Island pill at the top of the main screen.
- Architecture: Universal Binary (Apple Silicon arm64 & Intel x86_64).

## Architecture & Implementation Details
- Programming Language: Swift 5.9+
- UI Framework: SwiftUI & AppKit (NSPanel, NSWindow, NSStatusItem, NSPasteboard, NSSharingService).
- Memory Footprint: ~15 MB RAM at idle.
- Background Daemons: None. Notchify runs as a lightweight user agent menu bar application without invasive background helper tools.
- Auto-Start Option: Can be toggled in settings via ServiceManagement SMAppService.

## Detailed Feature Specifications

### 1. Full-Width Quick Notes (`QuickNotesFullView`)
- Live dark frosted glass text editor spanning the drawer width.
- Apple Notes Sync: Uses native AppleScript / NSAppleScript (`tell application "Notes" ... make new note`) to cleanly export notes directly into the Apple Notes app.
- Auto-save: Notes are persistently preserved in macOS AppStorage (`notchifyQuickNotes`).
- Actions: One-click Apple Notes export with animated feedback, one-click clipboard copy, and note clearing.

### 2. File Shelf (`StorageShelfColumnView`)
- Temporary drag-and-drop holding shelf for files, images, documents, and code snippets.
- Thumbnail previews powered by Apple QuickLookThumbnailing (`QLThumbnailGenerator`) and ImageIO.
- Drag out to any external application (Finder, Slack, Discord, Mail, browser upload fields).
- Badge count indicating how many items are waiting on the shelf.

### 3. Instant AirDrop (`FileShelfManager.sendAirDrop`)
- Dropping any file into the AirDrop zone triggers `NSSharingService(named: .sendViaAirDrop)`.
- Eliminates the need to open Finder, navigate to AirDrop, and wait for window discovery.

### 4. Pomodoro Focus Timer (`PomodoroManager`)
- 25-minute focus intervals and 5-minute break cycles.
- When the notch drawer is open, controls are located in the top-left toolstrip.
- When the notch drawer is closed, the live timer remains visible inside the right ear of the notch bezel (`⏱ 24:50`).
- Audible audio alert when a focus session or break ends using native AppKit sound (`NSSound(named: "Glass")`).

### 5. Live Camera Mirror (`MediaCameraColumnView` & `CameraManager`)
- Powered by AVFoundation (`AVCaptureSession`, `AVCaptureVideoDataOutput`).
- Displayed with horizontal mirror flip (`scaleEffect(x: -1, y: 1)`) so it mirrors real-life reflection.
- Designed for rapid personal appearance checks prior to video conferences.

### 6. Mini Music Player (`MusicManager`)
- Observes Apple Music / Spotify state via AppleScript and `NSDistributedNotificationCenter`.
- Shows album art badge, track title, artist, and audio play/pause toggle.

### 7. Screenshot Utility
- Dispatches macOS Screenshot utility (`/System/Applications/Utilities/Screenshot.app`).
- Drawer automatically hides for 150ms during capture to keep screenshots clean.

## Frequently Asked Questions

Q: Is Notchify free?
A: Yes, Notchify is 100% free and open-source under the MIT license with no paywalls, subscriptions, or telemetry.

Q: How do I resolve macOS Gatekeeper warning?
A: Run `xattr -cr /Applications/Notchify.app` in Terminal, or right-click `Notchify.app` and choose "Open".

Q: Where does Notchify save quick notes?
A: Notes are stored in local AppStorage continuously and can be exported with 1 click directly into Apple Notes.