📌 StickyPresenter
Keynote 전체 화면 위에 떠 있는 스티키 노트 & 텔레프롬프터 macOS 앱
Lucid Notes에서 영감을 받아, Keynote 프레젠테이션 중에도 메모와 대본을 볼 수 있는 플로팅 윈도우 앱입니다.
🔗 Links
✨ Features
🗒️ Floating Sticky Notes
- Keynote 전체 화면 모드 위에서도 항상 보임
- 6가지 포스트잇 색상 (Yellow, Pink, Green, Blue, Purple, Orange)
- 투명도(opacity) 조절 가능 (20% ~ 100%)
- 폰트 크기 조절
- 편집 잠금(Lock) 기능
- 드래그로 위치 이동, 리사이즈 가능
- 클립보드에서 바로 노트 생성
📺 Teleprompter Mode
- 프레젠테이션 대본 자동 스크롤
- 스크롤 속도 조절 (5 ~ 120 px/s)
- 폰트 크기 조절 (14pt ~ 48pt)
- 좌우 반전(Mirror) 모드 — 텔레프롬프터 유리 대응
- 재생/일시정지/되감기 컨트롤
- 상하 그라데이션 오버레이로 가독성 확보
🎯 Core Technical Features
NSPanel + fullScreenAuxiliary → Keynote 전체 화면 위에 표시canJoinAllSpaces → 모든 데스크톱/Space에서 표시- Menu Bar only 앱 (Dock 아이콘 없음)
nonactivatingPanel → Keynote 포커스를 빼앗지 않음
🚀 Xcode Project Setup
1. Create New Project
- Xcode → File → New → Project
- macOS → App 선택
- Product Name:
StickyPresenter
- Interface: SwiftUI
- Language: Swift
- Bundle Identifier:
com.leeo.StickyPresenter
- ❌ Use Core Data 체크 해제
- ❌ Include Tests 체크 해제
2. Add Source Files
프로젝트에 다음 파일들을 추가 (기존 ContentView.swift, xxxApp.swift 삭제):
StickyPresenter/
├── StickyPresenterApp.swift # App entry point + AppDelegate
├── Models.swift # NoteColor, StickyNote model
├── NoteManager.swift # Floating panel creation & management
├── StickyNoteView.swift # Post-it style note UI
├── TeleprompterView.swift # Teleprompter mode UI
└── Info.plist # LSUIElement = true (menu bar only)
3. Project Settings
Info.plist
- Application is agent (UIElement) →
YES (LSUIElement = true)
- 이렇게 하면 Dock에 앱 아이콘이 표시되지 않고, 메뉴바에서만 동작합니다.
Build Settings
- macOS Deployment Target: 14.0 이상
- App Sandbox:
NO (Entitlements에서 설정)
- 전체 화면 위에 윈도우를 띄우려면 Sandbox를 비활성화해야 합니다.
Signing
- Development 빌드: Automatically manage signing
- Sandbox OFF 상태이므로 Mac App Store 배포 시에는 별도 설정 필요
4. Build & Run
⌘ + R 로 빌드- 메뉴바에 📝 아이콘이 나타남
- 클릭하여 노트 추가, 텔레프롬프터 열기 등 사용
📋 Keyboard Shortcuts (Menu Bar)
| Shortcut | Action |
|---|
| ⌘N | New Sticky Note |
| ⌘V | New Note from Clipboard |
| ⌘T | Open Teleprompter |
| ⌘S | Show All Notes |
| ⌘H | Hide All Notes |
| ⌘Q | Quit App |
🔧 How It Works (Key Architecture)
Why NSPanel?
일반 NSWindow로는 Keynote 전체 화면 위에 표시할 수 없습니다. NSPanel에 다음 설정을 조합해야 합니다:
let panel = NSPanel(
contentRect: frame,
styleMask: [.nonactivatingPanel, .titled, .closable, .resizable, .fullSizeContentView],
backing: .buffered,
defer: false
)
// 최상위 윈도우 레벨
panel.level = NSWindow.Level(rawValue: Int(CGWindowLevelForKey(.maximumWindow)))
// 모든 Space + 전체 화면 앱 옆에 표시
panel.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .stationary]
// 앱 비활성화 시에도 숨기지 않음
panel.hidesOnDeactivate = false
// 포커스를 빼앗지 않음
panel.becomesKeyOnlyIfNeeded = true
Window Level Hierarchy
.screenSaver (1000) ← 화면 보호기
.maximumWindow (∞) ← ✅ StickyPresenter 여기!
.popUpMenu ← 팝업 메뉴
.mainMenu ← 메뉴 바
.floating ← 일반 플로팅 윈도우
.normal ← 일반 윈도우
🎨 Customization Ideas
📄 License
MIT License — 자유롭게 수정/배포 가능
Built with ❤️ for presenters who need notes on screen.
