LX Music Sync Server is a data sync server for LX Music with a full-featured built-in web player for aggregated search, playback and library management in the browser.
- v2.2.0
- Published at
- 11m ago
- 1,050
- Stars
- 5,367
- Download
- Synced at
- 6m ago
Latest release
v2.2.0Nov 10, 2026, 06:02 PMDownloads slow? Switch the source anytime above
README
Project Overview
LX Music Sync Server is both an enhanced data sync server for LX Music and a full-featured web player you can use to listen in any browser. It supports multi-platform aggregated search, playlist browsing and play-queue management, and adapts the Subsonic protocol so clients like AudioStream or Feishin can connect directly. Deployment is flexible, with a desktop client, Docker, source builds and release packages.
One server handles both sync and browser playback.
Key Features
- Web player: a modern interface with dark mode and mobile optimization
- Multi-source search: aggregated search across major music platforms
- Playlists and queue: browse multi-platform playlists, view detail panels and reorder the play queue by drag
- Playback control: playback modes, quality selection, lyrics, sleep timer and speed
- Cache management: automatically caches lyrics, URLs and song files with a dedicated control panel
- Lyric card sharing: customize aspect ratio, palette and line count to generate a poster
- Custom source management: import custom source scripts to add more sources
- Subsonic support: adapts the Subsonic protocol with platform prefixes such as
wy:andkg: - Public library: when enabled, all users share one public library and playlist list
Target Audience
- LX Music users
- Users who want to listen in a browser
- Users who need a self-hosted music sync server
- Subsonic client users
Quick Start
- Pull the image and start with Docker, or download the desktop client
- Mount the data, logs, cache and music directories as needed
- Open the web player address in a browser
- Log in to the admin console for system configuration
docker run -d -p 9527:9527 -v $(pwd)/data:/server/data --name lx-sync-server --restart unless-stopped xcq0607/lxserver:latestCore Advantages
- Sync and playback in one: a single server handles both data sync and web playback
- Flexible deployment: desktop client, Docker, source or release package
- Good protocol compatibility: Subsonic clients can connect to your library
- Smoother on weak networks: the automatic cache system keeps playback fluid
System Requirements
| Item | Requirement |
|---|---|
| OS | Windows, macOS, Linux, or Docker |
| Node.js | 16+ when running from source |
| Default port | 9527 |
| Persistence | Mount the data, logs, cache and music directories |
Notes
- The admin console default password is
123456; change it after deployment - A self-hosted server is open to the network by default, so pair it with an access password and a reverse proxy
- The project provides no copyrighted music content; configure your own sources
- Web player access can be protected via an environment variable or the admin system settings
Release history
Sort