An Electron and Vue Music Player That Puts an API in Your Hands
You've probably got music scattered across a few different services, and every desktop player you try either locks you into someone's ecosystem or refuses to talk to anything else on your machine. LX Music 桌面版 takes a different approach: it's a desktop music player built on Electron and Vue that runs a local HTTP server and can sync your data across devices if you've got a server to point it at.
What It Does
LX Music is a desktop music application built with Electron 30+ and Vue 3. It runs on Linux, macOS, and Windows 7 and above. There's also a separate mobile project if you want the same experience on your phone.
The interesting part isn't just that it plays music. Starting with v1.17.0, the app supports Scheme URLs, which means you can trigger LX Music from a browser or other applications. The project ships with a companion userscript you can install to wire that up, and the README points to documentation if you'd rather call the app yourself.
From v2.2.0 onward, there's a standalone data sync server you can deploy to your own infrastructure, turning LX Music into a private multi-device sync setup. And from v2.7.0, the app exposes an open API: enable it and a local HTTP service starts up, giving third-party software access to player-related interfaces.
Data lives in platform-appropriate config directories by default (on Linux, that's $XDG_CONFIG_HOME/lx-music-desktop or ~/.config/lx-music-desktop).
Why It's Cool
-
It's honest about who it's for. The README states outright that the default settings and UI aren't designed to be beginner-friendly, and that the project deliberately raises the barrier to entry. That's a refreshing stance. Instead of pretending every app needs to onboard a first-time user in thirty seconds, LX Music assumes you'll poke around the settings, read the playlist mechanism docs, and learn the keyboard and mouse shortcuts. If you're the kind of person who opens a new tool and immediately goes straight to preferences, you'll feel at home.
-
A local HTTP API changes what's possible. Once the open API service is running, other software on your machine can talk to your player. That's the kind of integration point desktop music apps usually don't offer. It means you could build your own controller, wire the player into a home automation setup, or connect it to whatever else you're running locally. The README links to documentation for the specifics.
-
Self-hosted sync is the right call. Rather than routing your listening data through someone else's cloud, LX Music gives you a separate sync server you can deploy yourself. If you've got a VPS or a home server sitting around, you can turn it into a private sync backend for your music library across devices. No account, no third party in the middle.
-
Scheme URLs make the browser connection real. The companion userscript means you can go from a web page to your desktop player without awkward copy-paste workflows. It's a small thing, but it's the kind of integration that makes a player feel like part of your system rather than an island.
-
It's cross-platform without pretending otherwise. Windows 7 support is notable—plenty of Electron apps have quietly dropped older Windows versions. If you're running an older machine, this one still works.
How to Try It
-
Head to the GitHub Releases page and grab the build for your platform. The README is explicit that GitHub is the only official distribution channel—anything else is a third-party repost and not affiliated with the project.
-
Before you start using it, take the README's advice: browse through the settings and adjust them to your liking. The defaults aren't tuned for newcomers by design. You'll also want to read up on the playlist mechanism and the available mouse and keyboard shortcuts.
-
If you want browser integration, install the LX Music companion userscript. For custom integrations, the Scheme URL documentation covers how to call the app yourself.
-
To enable the open API, turn it on in the settings and check the open API documentation for the interface details.
-
If you want multi-device sync, deploy the data sync server to your own infrastructure and point the app at it.
-
Check the changelog and FAQ if you run into anything. There's also a project direction update worth reading if you're curious about where things are heading.
The repository is at github.com/lyswhut/lx-music-desktop.
Final Thoughts
LX Music isn't trying to be everyone's music player, and the README says so plainly. It's for people who want a desktop player they can extend, integrate, and sync on their own terms—and who don't mind spending a few minutes in the settings to get there. If that sounds like you, the local API and self-hosted sync server are genuinely useful pieces of infrastructure that most desktop players don't bother offering. Worth a look if you've been wanting a player that treats you like someone who knows what they're doing.
Follow @githubprojects for more developer tools and open source projects.