LXmusic: Music App and Sync

Official repository: https://github.com/lyswhut/lx-music-desktop

Docker version of the v2.0.0 sync plugin: based entirely on the official 2.0 release archive, with no modifications.

Based entirely on the official 2.0 release archive, with no modifications.

Docker version of v2.0.0: woodchen/lxmusicsyncserver:v2.0.0

Official documentation follows

[1]: https://img.shields.io/github/release/lyswhut/lx-music-desktop

LX Music Desktop

Overview

A music app built with Electron + Vue.

Tech stack:

• Electron 15+
• Vue 3

Supported platforms:

• Windows 7 and later
• Mac OS
• Linux

For software changes, see: Changelog

To download the software, visit: Releases

Or download from cloud storage (MAC and windows versions are available): https://www.lanzoui.com/b0bf2cfa/ Password: glqw (if the link does not open, search Baidu for: Lanzou Cloud link won't open)

For common usage questions, see: FAQ

Currently, this project is officially published only on GitHub and Lanzou Cloud. All other channels are third-party redistributions and are not affiliated with this project!

To raise the barrier to entry, the default settings and UI interactions are not designed to be beginner-friendly. Before using the app, we recommend reviewing and adjusting the settings to your preferences, and reading about how music playlists work and available mouse and keyboard shortcuts

Scheme URL support

Since v1.17.0, Scheme URLs have been supported, allowing you to launch LX Music from a browser or other contexts. We developed a Tampermonkey script to use with this feature,

Script installation URL: https://greasyfork.org/zh-CN/scripts/438148br

If you want to invoke LX Music yourself, see Scheme URL support

Data sync service

Starting with v2.2.0, we released a standalone data sync service. If you have a server, you can deploy it as a private sync service for multiple devices. See the project's documentation for details

Launch arguments

The app currently supports the following launch arguments:

• -proxy-server Set a proxy server for all application traffic
• -proxy-bypass-list Bypass the proxy server for a semicolon-separated list of hosts
• -play Play music from the specified playlist on startup
• -search Automatically search for the specified content in the search box on startup
• -dha Launch with hardware acceleration disabled (Disable Hardware Acceleration)
• -dt Launch in non-transparent mode (Disable Transparent)
• -dhmkh Disable hardware media key handling (Disable Hardware Media Key Handling)

For detailed explanations, see Launch arguments

Data storage paths

By default, the app stores its data in:

• Windows: %APPDATA%/lx-music-desktop
• Linux: $XDG_CONFIG_HOME/lx-music-desktop or ~/.config/lx-music-desktop
• macOS: ~/Library/Application Support/lx-music-desktop

On Windows, if a portable directory exists in the program directory, it is automatically used for data storage (added in v1.17.0).

Using the source code

Moved to: https://lyswhut.github.io/lx-music-doc/desktop/use-source-code

UI

FAQ

The FAQ has moved to: https://lyswhut.github.io/lx-music-doc/desktop/faq

Contributing code

PRs are welcome, but please keep the following points in mind to help your PR get merged:

• For PRs that add new features, please create an issue first to confirm whether the feature is needed
• For bug-fix PRs, please describe the behavior before and after the fix and provide steps to reproduce
• For other types of PRs, include an appropriate description

Steps to contribute code:

1. Follow the source code usage guide to set up your development environment
2. Clone this repository and switch to the dev branch for development
3. Submit your PR to the dev branch

Project Terms

This project is distributed under the Apache License 2.0. The following terms supplement Apache License 2.0 and take precedence in the event of a conflict.

Definitions: In these terms, “this project” refers to the LX Music Desktop project; “user” refers to a user who accepts these terms; “official music platforms” collectively refers to the official platforms for the music sources built into this project, including Kuwo, Kugou, Migu, and others; “copyrighted data” refers to data whose copyright belongs to others, including but not limited to images, audio, and names.

1. This project retrieves data from the public servers of official music platforms, then displays it after basic filtering and merging. This project is therefore not responsible for the accuracy of the data.
2. Using this project may generate copyrighted data. This project does not own such data. To avoid copyright infringement, users must delete any copyrighted data generated while using this project within 24 hours.
3. The aliases used for official music platforms in this project are merely names used to refer to those platforms and carry no malicious intent. If an official music platform finds an alias inappropriate, it may contact this project to have it changed or removed.
4. Some resources used in this project, including but not limited to fonts and images, come from the internet. If any resource infringes copyright, please contact this project to have it removed.
5. Users are responsible for any direct, indirect, special, incidental, or consequential damages of any kind arising from these terms or from the use of, or inability to use, this project, including but not limited to damages resulting from loss of goodwill, work stoppage, computer failure or malfunction, or any other commercial damages or losses.
6. This project is completely free and open source on GitHub for people worldwide to learn about and discuss technology. This project makes no guarantee that its technologies comply with local laws and regulations. Using this project in violation of local laws and regulations is prohibited. Users are responsible for any unlawful or noncompliant conduct resulting from their use of this project, whether or not they know that local laws and regulations prohibit such use. This project assumes no direct, indirect, special, incidental, or consequential liability arising from such conduct.

By using this project, you accept the terms above.

Running a music platform is not easy. Please respect copyright and support legitimate releases.

This project is solely for exploring and researching technical feasibility. It does not accept any commercial partnerships (including but not limited to advertising) or donations.

If you have any questions, please mail to: lyswhut+qq.com (replace + with @)