A Dynamic Island–style music player for your Mac's notch, and now for Windows too.
See what's playing in Spotify, Apple Music and more, with wave bars that move with the music and take their color from the album art.
Features • macOS • Windows • Usage • Customization • Contributing • License
| 🎧 Now playing | A spinning vinyl-style cover peeks out on the left, waves roll on the right |
| 🌊 Music-reactive waves | Follow the real audio, with a smooth animation fallback if audio access is off |
| 🎨 Album-art colors | Waves and accents take their colors from the current cover |
| 🪄 Song-change pop | A short bouncy pop shows the new title and artist |
| 🖱️ Hover to expand | A Now Bar–style player with a scrolling title, controls, a wavy draggable progress bar and synced lyrics |
| 🎤 Karaoke lyrics | Full lyrics that fill with color as they're sung. Click any line to jump to it |
| 🔔 System pop-ups | Volume changes, headphones and other audio devices connecting, charging and low battery |
| 🖐️ Gestures | Swipe left/right to skip tracks, scroll up/down to change volume |
| 🎭 Themes | Now Bar (blurred album art), Classic (pure black), Neon (glowing outline), Glass (frosted) |
| 〰️ Wave styles | Flow, Bars, Line, Dots or Circle |
| ⚙️ Lives in the corner | Settings, Quit and Launch at login from the menu bar (macOS) or tray icon (Windows) |
| 🍎 macOS | 🪟 Windows | |
|---|---|---|
| Where it sits | Around the notch (or top center) | Top left, top center or top right, any distance from the edge |
| Screen | The built-in screen | Any screen you pick |
| Music apps | Spotify and Apple Music | Spotify, Apple Music, browsers, and any app in the media controls |
| Compact view | Cover and waves around the notch | Cover, scrolling title and waves |
| Reactive waves | Listens to the music app only | Listens to everything your speakers play |
| Volume | The music app's volume | The system volume |
| Full screen | — | Hides itself during full-screen videos, games and presentations |
Requirements: macOS 14.2 or later, Spotify and/or Apple Music, and the Swift 6 toolchain (Xcode, or just the Command Line Tools: xcode-select --install). Works on Macs with or without a notch.
git clone https://github.com/<your-username>/notchbeat.git
cd notchbeat/macos
./scripts/build-app.sh
open build/NotchBeat.appTo keep it around, drag macos/build/NotchBeat.app into your /Applications folder.
macOS asks for these permissions once:
| Permission | Why |
|---|---|
| Automation (Spotify / Music) | Read the current song and send play, skip, seek and volume commands |
| System Audio Recording | Let the waves react to the music. Audio is analyzed live and never saved |
You can change them later in System Settings → Privacy & Security.
Requirements: Windows 10 (version 2004 or later) or Windows 11, and the .NET 8 SDK to build.
git clone https://github.com/<your-username>/notchbeat.git
cd notchbeat\windows
.\build.ps1 -SelfContained
.\publish\NotchBeat.exe-SelfContainedmakes an exe that runs on any Windows 10/11 PC as is. Without it, the exe is much smaller but needs the .NET 8 Desktop Runtime installed.- No permissions are needed. Music apps report what they're playing to Windows, the same info shown in the volume flyout's media controls.
- To pick the position, click the tray icon (next to the clock) → Settings → Position.
Tip: to get a ready-made exe without installing .NET, open the Actions tab → Build → Run workflow, then download
NotchBeat-Windowsfrom the run's Artifacts.
| State | What you see |
|---|---|
| Idle | Hidden (behind the notch on Macs that have one) |
| Playing | Cover on the left, waves on the right |
| Hover | Expands into the full player |
| Click the lyric line | Opens full karaoke lyrics |
| Swipe ← / → (expanded) | Previous / next track |
| Scroll ↑ / ↓ (expanded) | Volume up / down |
On Windows, swiping means two-finger sideways scrolling on a touchpad, or a mouse with a tilt wheel.
Every size, color, corner radius, animation, wave and gesture setting lives in one file per platform:
macos/ Swift + SwiftUI app
├── Sources/NotchBeat/
│ ├── App/ Entry point, wiring, menu bar icon
│ ├── Island/ Notch window, hover and gestures, and the island views
│ ├── Music/ Music app connections (Spotify, Apple Music) and the now-playing state
│ ├── Audio/ Audio capture and frequency analysis for reactive waves
│ ├── Waves/ Wave styles and drawing
│ ├── Lyrics/ Synced lyrics from lrclib.net
│ ├── System/ Volume, audio device and battery monitors for system pop-ups
│ ├── Settings/ User preferences and the Settings window
│ └── Theme/ All visual settings, the themes, and album-art color extraction
├── Resources/ Info.plist for the .app bundle
└── scripts/ Build script
windows/ C# + WPF app (same structure, same names)
├── NotchBeat/
│ ├── App/ Tray icon and Windows API calls
│ ├── Island/ Island window, hover and gestures, and the custom-drawn views
│ ├── Music/ Windows media sessions and the now-playing state
│ ├── Audio/ Loopback capture and frequency analysis for reactive waves
│ ├── Waves/ Wave styles and drawing
│ ├── Lyrics/ Synced lyrics from lrclib.net
│ ├── Monitors/ Volume, audio device and battery monitors for system pop-ups
│ ├── Settings/ User preferences and the Settings window
│ └── Theme/ All visual settings, the themes, and album-art color extraction
└── build.ps1 Build script
Both apps share the same design. Data flows one way:
Music apps → NowPlaying → IslandModel → Views
- macOS: create a type that conforms to
MusicPlayer(seeSpotifyPlayer.swift) and add it toNowPlaying.players. - Windows: nothing to do. Any app that shows up in the Windows media controls already works.
macOS
cd macos
swift build # debug build
swift run # build and runNote: with
swift run, permissions are credited to your terminal app, and Launch at login only works from the.appbundle. Use./scripts/build-app.shto test the real app.
Windows
cd windows\NotchBeat
dotnet runOr open windows/NotchBeat/NotchBeat.csproj in Visual Studio 2022 or JetBrains Rider.
Contributions, bug reports and feature ideas are welcome! See CONTRIBUTING.md to get started.
- Fork the repo
- Create a branch:
git checkout -b feature/my-feature - Commit your changes:
git commit -m "Add my feature" - Push the branch:
git push origin feature/my-feature - Open a Pull Request
- Lyrics lookups send the song title, artist, album and duration to lrclib.net. Turn lyrics off in Settings to disable this.
- On macOS, Spotify artwork is downloaded from Spotify's image servers. On Windows, artwork comes straight from the music app.
- Nothing else leaves your computer. Audio is analyzed live and never recorded.
Released under the MIT License.
If you like NotchBeat, consider giving it a ⭐