LX Music：开源桌面音乐播放器

项目简介

LX Music（洛雪音乐助手）桌面版是一个基于 Electron 30+ 与 Vue 3 开发的音乐软件，使用 TypeScript 编写，采用 Apache-2.0 许可证发行。

已支持的平台：

• Windows 7 及以上
• macOS
• Linux

移动版项目地址：https://github.com/lyswhut/lx-music-mobile

主要功能

• 多平台音乐数据展示：从酷我、酷狗、咪咕等官方平台的公开服务器拉取数据，经过简单筛选与合并后展示。
• 自定义源播放：软件本身不提供音频数据，播放时把歌曲名、艺术家等信息传给设置中「自定义源」所选择的「源」，由该「源」返回在线链接。
• Scheme URL 调用（v1.17.0 起）：可在浏览器等场景下调用 LX Music，官方配套提供了油猴脚本，也可参考文档自行调用。
• 数据同步服务（v2.2.0 起）：提供独立的数据同步服务，有服务器时可自行部署，作为私人多端同步服务。
• 开放 API 服务（v2.7.0 起）：启用后会在本地启动一个 HTTP 服务，提供播放器相关接口供第三方软件调用。

安装与使用

安装包请从 GitHub Releases 下载。v2.12.6 的快捷链接：

• Windows x64：lx-music-desktop-v2.12.6-x64-Setup.exe
• macOS arm64：lx-music-desktop-2.12.6-arm64.dmg
• Linux amd64 deb：lx-music-desktop_2.12.6_amd64.deb

使用前建议先浏览一遍软件设置，并按喜好调整；同时建议阅读音乐播放列表机制以及可用的鼠标、键盘快捷操作。常见问题见桌面版常见问题。

默认情况下软件的数据存储目录为：

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

在 Windows 平台上，若程序文件夹中存在 portable 文件夹，则自动使用此文件夹作为数据存储文件夹（适用于 v1.17.0 及以上版本）。

若想从源码运行，请参阅源码使用方法。

注意事项

• 本软件的默认设置与 UI 操作不以新手友好为目标，使用前请先自行调整设置并阅读相关文档。
• 官方原始发布地址只有 GitHub Releases，其他渠道均为第三方转载，与本项目无关。
• 软件不对在线数据的合法性与准确性负责；使用过程中可能产生版权数据，请在 24 小时内 清除。请尊重版权、支持正版。
• 项目完全免费，仅用于技术可行性的探索与研究，禁止在违反当地法律法规的情况下使用。
• 官方说明：新项目 Any Listen 的桌面版与 Web 版已实现 LX Music 的大部分功能，并额外支持 WebDAV 歌曲播放、WebDAV 数据同步、独立播放列表等功能，后续开发精力将主要集中在新项目上，日常使用 LX Music 的用户可以尝试迁移。

---

本作品整理自 GitHub 开源项目 lyswhut/lx-music-desktop，原作者 @lyswhut，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。