XCQ0607

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 PM
Downloads 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: and kg:
  • 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

  1. Pull the image and start with Docker, or download the desktop client
  2. Mount the data, logs, cache and music directories as needed
  3. Open the web player address in a browser
  4. 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:latest

Core 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