Harmoni

Unified Music Controller

DEFAULT
?
Harmoni

Mr. Brightside

The Killers

1:283:42
Up Next
Somebody Told MeThe Killers
Take Me OutFranz Ferdinand
Feel Good Inc.Gorillaz
65
Main Player
Download Harmoni Windows · macOS · Linux
Mr. Brightside  · The Killers
Minibar
Mr. Brightside
The Killers
Locket Widget

"I initially built this app because I wanted my Sonos to play on my computer without having to look at the horrible Sonos UI (lol). I've always wanted a minibar of the song that's playing, always on top of all windows, since I'd be gaming, working, or studying and still wanted to glance at the lyrics.

Instead of finding an app, I decided to build one that also works with Spotify and YouTube Music, so that people whose needs align with mine can have their wish satisfied too. I made it open source so users can have more customizability with themes, functions, and possibly fun animations or interactions with the minibar and locket.

I had hoped to take it a step further with full Spotify API integration, but since Spotify stopped handing out approvals to apps from small devs, I could not go down this path. Alas, you would still need to open Spotify to run Harmoni. Anyways, I hope that you would enjoy this fun little application that I had designed and built in my spare time!!"

- uy/nikki

About Harmoni

Harmoni is a cross-platform desktop music controller that unifies all your music sources into one customizable interface. Whether you're streaming from Spotify, playing YouTube Music in your browser, controlling Sonos speakers across your home, or playing local files from your library — Harmoni brings everything together with a single, beautiful player.

Music Sources

Sonos Speakers
Auto-discovers Sonos devices on your network. Control playback, volume, queue, shuffle, and repeat across rooms. Browse favorites and playlists.
Local Media Detection
Automatically detects music playing in Spotify, YouTube Music, or any browser/app. Controls play/pause/next/prev through system media APIs.
Local File Playback
Play MP3, FLAC, M4A, OGG, and WAV files directly. Reads metadata (title, artist, album, art). Includes search, shuffle, repeat, and volume control.
Spotify Integration
Browse playlists, liked songs, and search the Spotify catalog. Note: Spotify has stopped approving API access for small developer apps, so this feature is limited. If you really want to use this function, you can create your own developer app at developer.spotify.com and add yourself to it, given that you have Spotify Premium.

Overlays & Widgets

Minibar
Compact always-on-top overlay. Shows track info, controls, and synced lyrics. Draggable, themed, with position presets.
Locket Widget
Tiny floating widget with album art, track name, progress bar, and playback controls. Always on top, draggable.
System Tray
Quick controls from the tray icon. Play/pause, next/prev, toggle widgets, and quit — all without opening the main window.

11 Themes

Each theme is more than a color swap — they feature unique layouts, animations, and visual elements that transform the entire experience.

Default — Dark glassmorphism with blurred album art background
Light — Clean white, Apple Music inspired, pill-shaped play button
Windows XP — Authentic Luna Blue with 3D inset panels and gradient buttons
Vinyl — Warm turntable feel with spinning circular art and vinyl grooves
Neon — Cyberpunk synthwave with scanlines, glowing borders, and pulsing buttons
Radio — Vintage AM/FM receiver with amber LCD text and monospace fonts
Retro — Cream paper with fieldset-style labeled sections and sharp corners
Terminal — Dark hacker terminal with green accent, CRT scanlines, and monospace
Bloom — Soft purple Fluent Design with blurred backgrounds and extra rounding
Starry Night — Deep space with twinkling stars, shooting stars, and cosmic glow
Ziro — Clean geometric with bold blue accent stripes and modern flat design

Features

♫ Synced lyrics via LRCLIB (real-time highlight)
⏰ Sleep timer (15/30/60/90 min presets)
⌨ Global media key support (play/pause/next/prev)
🔍 Search across Spotify, local files, and queue
📋 Play history with timestamps
🎮 Game-compatible overlays (borderless windowed)
🔄 Auto-update via GitHub Releases
💬 In-app feedback form (bug reports & suggestions)
🔒 Single instance lock
💾 Persists theme, window positions, and last device

Keyboard Shortcuts

Ctrl+Shift+M Toggle minibar
Space Play / Pause
Escape Close overlays
Scroll Volume (on minibar)

Platform Support

Windows
NSIS installer
Auto-update
GSMTC media detection
macOS
Universal .app (Intel + M-chip)
Auto-update
AppleScript detection
Linux
AppImage
Auto-update
playerctl / MPRIS2

Tech Stack

Built with Electron for cross-platform desktop support, Node.js backend services, sonos npm library for UPnP device control, music-metadata for local file parsing, electron-updater for auto-updates, and LRCLIB for synced lyrics. The UI is vanilla HTML/CSS/JS with 1800+ lines of theme CSS across 11 distinct visual identities.

Credits

uy/nikki — design, development

gian/donnygi — macOS environment tester