lx-music-desktop

lyswhutApache-2.0活跃维护有专家点评

基于 Electron 的跨平台桌面音乐播放器，聚合多源在线音乐搜索与播放，界面清爽，适合日常听歌。

一个基于 Electron 的音乐软件

v2.12.6发布于 2026-09-19 02:23 UTC55,242star +110 / 7 天7,122fork同步于 2026-11-11 05:18 UTC

音乐播放器桌面应用 Electron 在线音乐跨平台

对比 GitHub 官网 electron javascript music-player vue

专家点评

上手难度：进阶更新于 2026-11-11

Electron 桌面音乐客户端，播放链路靠自定义源拼装，不内置任何音频数据

适用场景

需要跨平台（含 Windows 7）桌面播放器且想自己控制音源来源：它把「播放器」和「内容源」拆开，换源比换客户端便宜
已有自建音乐库或第三方源接口，想套一个现成 UI 和播放列表机制：省掉 Electron + Vue 的客户端壳开发
需要从浏览器或其他程序唤起播放器：Scheme URL 和 v2.7.0 起的本地 HTTP 开放 API 是给外部集成留的口子，纯播放器类项目少有
多设备想同步播放列表和设置：可以自己部署同步服务，数据不落在第三方

踩坑

装完打不开歌是常态：README 明说软件不提供音频数据，必须先在设置里选自定义源；issue 里「收集音源」「给个源」这类帖子反复出现，说明源本身要自己找、且会失效
源链接过期导致播放失败被反复报（有 issue 直接请求不要再开同类 issue），意味着这不是偶发故障而是持续状态，别把它当稳定服务依赖
默认设置和 UI 不以新手友好为目标，播放列表机制另有文档；不先读一遍就上手会卡在列表/歌单逻辑上
只从 GitHub Releases 拿安装包，其他渠道是第三方转载，来源不可控

怎么上手

由 README 提炼，执行前请确认

原文

从 GitHub Releases 下载对应平台安装包：https://github.com/lyswhut/lx-music-desktop/releases

硬件要求按 README 说明

README 未说明硬件要求；已支持 Linux、macOS、Windows 7 及以上平台

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于 Electron 和 Vue 3 的跨平台桌面音乐播放器，通过自定义源获取在线音频

基于 Electron 的跨平台桌面音乐播放器，聚合多源在线音乐搜索与播放，界面清爽，适合日常听歌。

核心能力

基于 Electron 30+ 与 Vue 3 构建桌面客户端
通过自定义源设置获取在线音频播放链接
支持 Scheme URL 供浏览器等外部场景调用
v2.7.0 起可启用本地 HTTP 开放 API 服务
可部署独立同步服务实现多端数据同步

容易踩的坑

软件本身不提供音频数据，需在设置中选择可用的自定义源才能播放；默认设置与 UI 不以新手友好为目标，建议先浏览调整设置并阅读播放列表机制文档；官方发布渠道仅 GitHub，其他渠道为第三方转载

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v2.12.6

全部 release

v2.12.62.12.6最新正式版2026-09-19 · 2026-09-19 02:23 UTC

目前新项目 Any Listen 的桌面版、Web 版已实现 LX Music 的大部分功能，并额外支持 WebDAV 歌曲播放、WebDAV 数据同步、独立播放列表等功能。以后的开发精力将主要集中在新项目上，之前大家在 LX Music 提的功能我们也会考虑在新项目中添加。对于日常使用 LX Music 的人可以试试迁移到 Any Listen，若遇到任何问题可以发 issue 反馈。 Any Listen 的项目地址为 https://github.com/any-listen/any-listen

优化

优化 tx 推荐歌单列表
优化禁用透明窗口的窗口边框显示效果

修复

修复打开某些 kg 歌单时歌曲丢失的问题
修复 Windows 7 无法启动的问题
修复禁用透明窗口时按 F11 无法全屏的问题

安装包快捷链接

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

File MD5


EE6E6C58B4EBCBADD689A26904245412  lx-music-desktop-v2.12.6-arm64-Setup.exe
FC8D5CA1486C20A80A3872CAC164BD96  lx-music-desktop-v2.12.6-x64-Setup.exe
E465D42988B2DEB1524C3FB93FB8C93C  lx-music-desktop-v2.12.6-win_arm64-green.7z
D45A6D2069F029152E114D8E6E4D3285  lx-music-desktop-v2.12.6-win_x64-green.7z
555B3AE80DABAADC12BD9FAC054844B7  lx-music-desktop-v2.12.6-win7_x64-Setup.exe
3FC618E78ACCDC3BCB84FE28506DD968  lx-music-desktop-v2.12.6-win7_x64-green.7z
98C8CCAA07D25C9D8B3D93AE4145275E  lx-music-desktop-v2.12.6-win7_x86-green.7z

MD5 (lx-music-desktop-2.12.6-arm64.dmg) = de41c1e9be5c1e761e35994f06a61bcf
MD5 (lx-music-desktop-2.12.6-x64.dmg) = ad60f91f8ea01116e3518500d353b503

8e3cec15c0ec0d0c56bff682a5e8bb54  lx-music-desktop_2.12.6_amd64.deb
2811f0cd205af44246c004067711e7ba  lx-music-desktop_2.12.6_arm64.deb
d43640d0971df6c4844a5a7ad63a7a9f  lx-music-desktop_2.12.6_armv7l.deb
5f974677148d22eb692fc4c5b84c80d2  lx-music-desktop-2.12.6.x64.rpm
fcf688e6ecfdbd92c39fa781fdf1a1f5  lx-music-desktop_2.12.6_x64.pacman
9c1107bf03e4b3c5502ed47992706336  lx-music-desktop_2.12.6_x64.AppImage

软件安装包说明

v2.12.52.12.52026-09-13 · 2026-09-13 17:24 UTC

查看更新说明

修复

修复自定义主题编辑器的颜色选择器默认值显示异常的问题（#2957）
修复下载的 MP3 文件内嵌歌曲数据失败的问题（#2959）

安装包快捷链接

Windows x64: lx-music-desktop-v2.12.5-x64-Setup.exe
MacOS arm64: lx-music-desktop-2.12.5-arm64.dmg
Linux amd64 deb: lx-music-desktop_2.12.5_amd64.deb

File MD5

60788AF789A32A16E1D5AB2B40570D45  lx-music-desktop-v2.12.5-arm64-Setup.exe
DA92BA41848DB2605C07E8427FAD192A  lx-music-desktop-v2.12.5-x64-Setup.exe
7B828CDC7ADAE6D08F0E7D288F846AEA  lx-music-desktop-v2.12.5-win_arm64-green.7z
1F109D12022A45888AE6E5B0C2DCEEFB  lx-music-desktop-v2.12.5-win_x64-green.7z
5E333B0D09812D2B4201F7084BD72FC7  lx-music-desktop-v2.12.5-win7_x64-Setup.exe
37A657F2B6E0DE33E3BE5860B8AD2576  lx-music-desktop-v2.12.5-win7_x64-green.7z
458E89515CF9F862D2283248FE2BFA14  lx-music-desktop-v2.12.5-win7_x86-green.7z

MD5 (lx-music-desktop-2.12.5-arm64.dmg) = 08546c997e2e54e13c18a361ec3c8342
MD5 (lx-music-desktop-2.12.5-x64.dmg) = 876137f737075ddfcc2df36580c70f3d

c14035816430538622aa913d92c822ce  lx-music-desktop_2.12.5_amd64.deb
940748458aa9293f5631a85eb8655bf5  lx-music-desktop_2.12.5_arm64.deb
8bac0431a6c039fbd6e5a05ea1019a15  lx-music-desktop_2.12.5_armv7l.deb
1ec4e8e169d8a230fb612aaed193a59f  lx-music-desktop-2.12.5.x64.rpm
c4cf29b0ef095eda5b605a711fb5a483  lx-music-desktop_2.12.5_x64.pacman
5259bbf5bf01f333bf31ad93c49d0d4b  lx-music-desktop_2.12.5_x64.AppImage

软件安装包说明

v2.12.42.12.42026-09-12 · 2026-09-12 13:11 UTC

查看更新说明

修复

修复自定义主题背景图片无法显示的问题

安装包快捷链接

Windows x64: lx-music-desktop-v2.12.4-x64-Setup.exe
MacOS arm64: lx-music-desktop-2.12.4-arm64.dmg
Linux amd64 deb: lx-music-desktop_2.12.4_amd64.deb

File MD5

11DEB150E3F3FB6BE83684AAB9D9BD79  lx-music-desktop-v2.12.4-arm64-Setup.exe
EF111435343AE47193274386339A3B17  lx-music-desktop-v2.12.4-x64-Setup.exe
328EAB7C41894DEE6903B96FA29ABE35  lx-music-desktop-v2.12.4-win_arm64-green.7z
4536C1764A111A72F0FFD1B6BC26B291  lx-music-desktop-v2.12.4-win_x64-green.7z
0A268A2418F778624A28D5AC64A78174  lx-music-desktop-v2.12.4-win7_x64-Setup.exe
65E3B8416832022A5855508F0667C5E8  lx-music-desktop-v2.12.4-win7_x64-green.7z
8E113992FD5840170FDA8104E78450E7  lx-music-desktop-v2.12.4-win7_x86-green.7z

MD5 (lx-music-desktop-2.12.4-arm64.dmg) = 2d8c164fe7f03ecbcca61a97ddb5d402
MD5 (lx-music-desktop-2.12.4-x64.dmg) = e36d2a257fe75f3bd7791d8f1b6bb5e1

47ea6b3bf407b030f61a730915501343  lx-music-desktop_2.12.4_amd64.deb
ff9530f5c73eed058b615514e4ad6520  lx-music-desktop_2.12.4_arm64.deb
ba8c4187d1f87506f4aef7bd29a652ac  lx-music-desktop_2.12.4_armv7l.deb
4f4f88296dc6fabaf2691c23a014e137  lx-music-desktop-2.12.4.x64.rpm
921585545c6bb143e6b4f039b5740d4b  lx-music-desktop_2.12.4_x64.pacman
e66d340d73c2673f4a7dec1523441d0e  lx-music-desktop_2.12.4_x64.AppImage

软件安装包说明

v2.12.32.12.32026-09-12 · 2026-09-12 05:23 UTC
查看更新说明
目前新项目 Any Listen 的桌面版、Web 版已实现 LX Music 的大部分功能，并额外支持 WebDAV 歌曲播放、WebDAV 数据同步、独立播放列表等功能。以后的开发精力将主要集中在新项目上，之前大家在 LX Music 提的功能我们也会考虑在新项目中添加。对于日常使用 LX Music 的人可以试试迁移到 Any Listen，若遇到任何问题可以发 issue 反馈。 Any Listen 的项目地址为 https://github.com/any-listen/any-listen

优化
- 优化kw歌单列表数据显示
- 同步服务在连接时允许URL重定向
- Linux 点击托盘时将显示主界面（#2840）
- 优化自动换源歌曲匹配机制
修复
- 修复 kg 搜索结果显示问题 (#2782)
- 修复某些情况下开放 API 获取到的音量为 0 的问题 (#2790)
- 修复 mg 图片、歌词获取
- 修复某些 tx 歌单打开失败的问题 (#1060, @ght-000)
- 修复在某些情况下添加、移动歌曲时可能导致保存的歌曲顺序不对的问题（#2842）
- 修复歌词标签解析格式没有严格按照标准的问题（#2855）
- 修复 tx 歌曲搜索失败的问题（#2848, @ikun0014）
安装包快捷链接
- Windows x64: lx-music-desktop-v2.12.3-x64-Setup.exe
- MacOS arm64: lx-music-desktop-2.12.3-arm64.dmg
- Linux amd64 deb: lx-music-desktop_2.12.3_amd64.deb
File MD5
```
DC099FE3EEB367887A10D69049AD5E3F  lx-music-desktop-v2.12.3-arm64-Setup.exe
58089AF957A54E7C0BB4A08507782835  lx-music-desktop-v2.12.3-x64-Setup.exe
AEE8A2E55C2E5426E74AC83C357F7A2B  lx-music-desktop-v2.12.3-win_arm64-green.7z
D2B168210746F7E36CB5ECD42C10ED2D  lx-music-desktop-v2.12.3-win_x64-green.7z
FF90AB7A89137B2E919DE0F99E3CBFEF  lx-music-desktop-v2.12.3-win7_x64-Setup.exe
6E2BA0A3BD3415075BC170FC025D481B  lx-music-desktop-v2.12.3-win7_x64-green.7z
8F2F9ABC8E042E5F7AE30B766276FC16  lx-music-desktop-v2.12.3-win7_x86-green.7z

MD5 (lx-music-desktop-2.12.3-arm64.dmg) = b9aacbc215a53b1bf53811be97216162
MD5 (lx-music-desktop-2.12.3-x64.dmg) = f3025a03a08d5d235d0d822b5dd8c10f

9f4878fbf52206ba13c3621af340ded3  lx-music-desktop_2.12.3_amd64.deb
d3ac513e3aac266fb5c7b9b002677c04  lx-music-desktop_2.12.3_arm64.deb
93d90cf28133c3643983caffc8cd8141  lx-music-desktop_2.12.3_armv7l.deb
a67f12fc55022aefaa4c4a2ea845b0c0  lx-music-desktop-2.12.3.x64.rpm
6ba62ac35d1a7ee0caf2148eae71438c  lx-music-desktop_2.12.3_x64.pacman
9491b256f1255f734152e3b217dd5553  lx-music-desktop_2.12.3_x64.AppImage
```
软件安装包说明

v2.12.22.12.22026-05-01 · 2026-05-01 05:35 UTC

查看更新说明

我们很高兴地宣布新项目 Any Listen 的桌面版已发布，目前已支持列表跟随本地文件自动更新、加载并播放WebDAV上的歌曲等功能，更多功能仍在积极开发中，桌面版与Web版将同步更新。对于有播放本地音乐或播放服务器上音乐需求的人可以试试，若遇到任何问题可以发 issue 反馈。

优化

优化歌单内歌曲搜索结果排序 (#2734)

修复

修复桌面歌词的鼠标移入歌词区域时提高透明度设置不稳定的问题（#2679, @Little100）
修复某些情况下可能播放没有声音的问题（#2693）
修复 tx 搜索结果显示异常的问题（#2753）
修复音乐名称和歌手信息格式化问题（#2733）

其他

更新 Electron 到 40.8.3

File MD5

B4F3EF439969330A8DA0C002338887A3  lx-music-desktop-v2.12.2-arm64-Setup.exe
AC951EF427B3E81D7C508626958954E2  lx-music-desktop-v2.12.2-x64-Setup.exe
CFAE81EBCC351F388AAC51BFF0681514  lx-music-desktop-v2.12.2-win_arm64-green.7z
BCB3D63D6BFFD8F575BD14D849587B59  lx-music-desktop-v2.12.2-win_x64-green.7z
96EC424BAD5C74506F134A3DF0FED2B7  lx-music-desktop-v2.12.2-win7_x64-Setup.exe
BA8382EE4C577BE5006800471CB9C57E  lx-music-desktop-v2.12.2-win7_x64-green.7z
D1708A9EFD7F7387653EF18C6D507589  lx-music-desktop-v2.12.2-win7_x86-green.7z

MD5 (lx-music-desktop-2.12.2-arm64.dmg) = f304daf9fd17a750bb8940d98baba6cd
MD5 (lx-music-desktop-2.12.2-x64.dmg) = c90c760f596bf326fe30f11415d34553

3d4f6cf6fbe786c8e8a2fe91b5b5dd9c  lx-music-desktop_2.12.2_amd64.deb
04ce0fbd713f1a913ef2ee7d76182071  lx-music-desktop_2.12.2_arm64.deb
6123df1d14b9c01579e433833929934c  lx-music-desktop_2.12.2_armv7l.deb
e3d3c803f5b2a6862b44944d84805534  lx-music-desktop-2.12.2.x64.rpm
6ed5fdfe7cc027706f9103a6a453501f  lx-music-desktop_2.12.2_x64.pacman
eec29d0ce77a8b883b1f6182e6e0065c  lx-music-desktop_2.12.2_x64.AppImage

软件安装包说明

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

说明

所用技术栈：

Electron 30+
Vue 3

已支持的平台：

Linux
macOS
Windows 7 及以上

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

[!NOTE] 目前新项目 Any Listen 的桌面版、Web 版已实现 LX Music 的大部分功能，并额外支持 WebDAV 歌曲播放、WebDAV 数据同步、独立播放列表等功能。我们以后的开发精力将主要集中在新项目上，之前大家在 LX Music 提的功能我们也会考虑在新项目中添加。对于日常使用 LX Music 的人可以试试迁移到 Any Listen，若遇到任何问题可以发 issue 反馈。

关于我们开发新项目的原因，可以参考：LX Music 项目发展调整与新项目计划。

软件变化请查看更新日志。

软件下载请查看 GitHub Releases。

使用常见问题请参阅桌面版常见问题。

目前本项目的原始发布地址只有 GitHub，其他渠道均为第三方转载发布，与本项目无关！

为了提高使用门槛，本软件内的默认设置、UI 操作不以新手友好为目标，所以使用前建议先根据你的喜好浏览调整一遍软件设置，阅读一遍音乐播放列表机制及可用的鼠标、键盘快捷操作。

Scheme URL 支持

从 v1.17.0 起支持 Scheme URL，可以使用此功能在浏览器等场景下调用 LX Music，我们开发了一个油猴脚本配套使用。

脚本安装地址：LX Music 辅助脚本。

若你想自己调用 LX Music，可以参考文档「Scheme URL 支持」部分。

数据同步服务

从 v2.2.0 起，我们发布了一个独立的数据同步服务。如果你有服务器，可以将其部署到服务器上作为私人多端同步服务使用，详情看该项目说明。

开放 API 支持

从 v2.7.0 起支持开放 API 服务。启用该功能后，将会在本地启动一个 HTTP 服务，提供播放器相关的接口供第三方软件调用，详情看文档「开放 API 服务」部分。

数据存储目录

默认情况下，软件的数据存储在：

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 及以上版本）。

用户界面

贡献代码

本项目欢迎 PR，但为了 PR 能顺利合并，需要注意以下几点：

对于添加新功能的 PR，建议在提交 PR 前先创建 Issue 进行说明，以确认该功能是否确实需要。
对于修复 bug 的 PR，请提供修复前后的说明及重现方式。
对于其他类型的 PR，则适当附上说明。

贡献代码步骤：

参照源码使用方法设置开发环境；
克隆本仓库代码并切换至 dev 分支进行开发；
提交 PR 至 dev 分支。

源码使用方法

请参阅：https://lyswhut.github.io/lx-music-doc/desktop/use-source-code

项目协议

本项目基于 Apache License 2.0 许可证发行，以下协议是对于 Apache License 2.0 的补充，如有冲突，以以下协议为准。

词语约定：本协议中的“本项目”指 LX Music（洛雪音乐助手）桌面版项目；“使用者”指签署本协议的使用者；“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称；“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。

一、数据来源

1.1 本项目的各官方平台在线数据来源原理是从其公开服务器中拉取数据（与未登录状态在官方平台 APP 获取的数据相同），经过对数据简单地筛选与合并后进行展示，因此本项目不对数据的合法性、准确性负责。

1.2 本项目本身没有获取某个音频数据的能力，本项目使用的在线音频数据来源来自软件设置内“自定义源”设置所选择的“源”返回的在线链接。例如播放某首歌，本项目所做的只是将希望播放的歌曲名、艺术家等信息传递给“源”，若“源”返回了一个链接，则本项目将认为这就是该歌曲的音频数据而进行使用，至于这是不是正确的音频数据本项目无法校验其准确性，所以使用本项目的过程中可能会出现希望播放的音频与实际播放的音频不对应或者无法播放的问题。

1.3 本项目的非官方平台数据（例如“我的列表”内列表）来自使用者本地系统或者使用者连接的同步服务，本项目不对这些数据的合法性、准确性负责。

二、版权数据

2.1 使用本项目的过程中可能会产生版权数据。对于这些版权数据，本项目不拥有它们的所有权。为了避免侵权，使用者务必在 24 小时内 清除使用本项目的过程中所产生的版权数据。

三、音乐平台别名

3.1 本项目内的官方音乐平台别名为本项目内对官方音乐平台的一个称呼，不包含恶意。如果官方音乐平台觉得不妥，可联系本项目更改或移除。

四、资源使用

4.1 本项目内使用的部分包括但不限于字体、图片等资源来源于互联网。如果出现侵权可联系本项目移除。

五、免责声明

5.1 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责。

六、使用限制

6.1 本项目完全免费，且开源发布于 GitHub 面向全世界人用作对技术的学习交流。本项目不对项目内的技术可能存在违反当地法律法规的行为作保证。

6.2 禁止在违反当地法律法规的情况下使用本项目。 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担，本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

七、版权保护

7.1 音乐平台不易，请尊重版权，支持正版。

八、非商业性质

8.1 本项目仅用于对技术可行性的探索及研究，不接受任何商业（包括但不限于广告等）合作及捐赠。

九、接受协议

9.1 若你使用了本项目，即代表你接受本协议。

若对此有疑问请 mail to: lyswhut+qq.com (请将 + 替换为 @)

专家点评

适用场景

踩坑

同类对比

怎么上手

项目说明

核心能力

容易踩的坑

最近发版

优化

修复

安装包快捷链接

File MD5

修复

安装包快捷链接

File MD5

修复

安装包快捷链接

File MD5

优化

修复

安装包快捷链接

File MD5

优化

修复

其他

File MD5

用户点评

README 原文

说明

Scheme URL 支持

数据同步服务

开放 API 支持

数据存储目录

用户界面

贡献代码

源码使用方法

项目协议

一、数据来源

二、版权数据

三、音乐平台别名

四、资源使用

五、免责声明

六、使用限制

七、版权保护

八、非商业性质

九、接受协议

相关项目