Turn your MacBook notch into something useful.
A native macOS dashboard for media controls, productivity tools, system information, and customizable widgets.
WaveNotch is a native macOS application that transforms the area around the MacBook notch into an interactive dashboard.
Instead of treating the notch as unused screen space, WaveNotch turns it into a central place for media controls, productivity tools, system information, and customizable widgets.
The application is built primarily with Swift and SwiftUI.
Control currently playing media directly from the notch.
- Playback controls
- Track information
- Album artwork
- Queue management
- Spotify integration
- Apple Music / system media support
View lyrics alongside currently playing music.
WaveNotch includes dedicated lyric management and search functionality for displaying synchronized song lyrics.
WaveNotch includes a plugin-based widget system that allows different tools to be displayed inside the notch interface.
Current widgets and integrations include:
- 📁 File Tray
- 📶 Network Speed
- 💻 Hardware HUD
- ✅ Tasks
- 📸 Screen Capture
- 🐾 Notch Pets
- 📅 Calendar functionality
- 🎵 Media controls
WaveNotch integrates directly with macOS functionality, including:
- Global shortcuts
- Launch at login
- System notifications
- Bluetooth-connected device information
- Local weather support
- Custom URL schemes
- Background media monitoring
WaveNotch is organized into several main layers:
Notch/
├── App/
├── Components/
├── Extensions/
├── Managers/
├── Models/
└── Views/
Long-running application functionality is separated into dedicated managers.
Examples include:
NowPlayingManager
SpotifyAuthManager
GoogleCalendarManager
PluginManager
HardwareHUDManager
SystemNotificationMonitor
DashboardManager
This separates system integrations and state management from the SwiftUI presentation layer.
The UI is built with SwiftUI and separated into feature-specific views and widgets, including:
ContentView
PlayerTabView
PlaylistTabView
PluginStoreView
FileTrayWidget
NetworkSpeedWidget
HardwareHUDWidget
TasksWidget
ScreenCaptureWidget
NotchPetsWidget
- Swift
- SwiftUI
- macOS native APIs
- Xcode
Integrations include functionality around:
- Spotify
- Apple/system media
- Google Calendar
- Bluetooth devices
- macOS notifications
- Location-based weather
Clone the repository:
git clone https://github.com/dIwnsgml/WaveNotch.git
cd WaveNotchOpen:
Notch.xcodeproj
in Xcode and run the macOS target.
Some integrations may require local credentials or permissions before they function.
Certain optional WaveNotch features require macOS permissions.
Examples include:
- Location access for local weather
- Bluetooth access for connected-device battery information
- System permissions required by individual widgets
These capabilities are used only when their related functionality is enabled.
WaveNotch was actively developed from April 2026 to August 2026.
The repository is public as a showcase of the project's implementation and architecture.
Jason (Junhee) Lee
- Website: leejason.dev
- LinkedIn: jason-leee
- GitHub: dIwnsgml
