lx-music-desktop version history
10 releases tracked, newest first.
v2.12.2
May 1, 2026- Optimized song search result sorting in playlists.
- Fixed unstable transparency settings for desktop lyrics when hovering.
- Resolved issues with no sound during playback in certain cases.
- Updated Electron to version 40.8.3.
10 downloads
v2.12.1
Feb 16, 2026我们很高兴地宣布新项目 [Any Listen](https://github.com/any-listen/any-listen) 的桌面版已发布,目前已支持列表跟随本地文件自动更新、加载并播放WebDAV上的歌曲等功能,更多功能仍在积极开发中,桌面版与Web版将同步更新。
对于有播放本地音乐或播放服务器上音乐需求的人可以试试,若遇到任何问题可以发 issue 反馈。
### 优化
- 优化托盘图标行为:在非 Windows 系统中,点击托盘图标时不再显示主窗口
### 修复
- 修复音量条在调整音量时实际音量与显示的数值不一致的问题(#2606)
- 修复某些情况下搜索框的搜索按钮布局错位的问题(#2622)
### File MD5
```
F23B6F88E7E0BBF0BB46125EC6A78903 lx-music-desktop-v2.12.1-arm64-Setup.exe
19150F578D66B5530AD5D16591E69CE4 lx-music-desktop-v2.12.1-x64-Setup.exe
09F88156696BEF2BAD385790AC1FD167 lx-music-desktop-v2.12.1-win_arm64-green.7z
54CEA4FA911732717376843541CC1364 lx-music-desktop-v2.12.1-win_x64-green.7z
90FC3852E250C644AF7D4AA5BADD3B14 lx-music-desktop-v2.12.1-win7_x64-Setup.exe
E2CF353D185B1C5DC21DDBE5850B2E4D lx-music-desktop-v2.12.1-win7_x64-green.7z
F4E84C978A0FA1428FA3B942C85829C8 lx-music-desktop-v2.12.1-win7_x86-green.7z
MD5 (lx-music-desktop-2.12.1-arm64.dmg) = 9039ee357d28b72035a17bec356c5d66
MD5 (lx-music-desktop-2.12.1-x64.dmg) = e6cf66d11de014bf494339d166785f30
1c089d135b4434da88cd1b1bf35afbb5 lx-music-desktop_2.12.1_amd64.deb
1d293cd3e8fea696975b89a76f0cbc8d lx-music-desktop_2.12.1_arm64.deb
5b6392521e540c7de6a49cc44
10 downloads
v2.12.0
Nov 29, 2025我们很高兴地宣布新项目 [Any Listen](https://github.com/any-listen/any-listen) 的桌面版已发布,目前已支持列表跟随本地文件自动更新、加载并播放WebDAV上的歌曲等功能,更多功能仍在积极开发中,桌面版与Web版将同步更新。
对于有播放本地音乐或播放服务器上音乐需求的人可以试试,若遇到任何问题可以发 issue 反馈。
### 新增
- 新增「设置 → 其他设置 → 主窗口使用软件内置的圆角及阴影」选项 (#2360)
*默认启用,关闭后将使用系统原生的窗口样式,该选项重启软件后生效*
- 开放 API 新增播放器声音大小、静音、播放进度控制、完整歌词获取,详情看接入文档 (#2386)
- 新增「设置 → 播放设置 → 调换歌词翻译与歌词罗马音位置」选项,默认关闭 (#2451)
- 新增启动参数 `-hidden`,在启动时将软件最小化到系统托盘 (#2459)
- 新增 Any Listen 歌词(用于支持已下载歌曲的歌词逐字播放)标签数据读取与播放 (#2485)
- 新增 Any Listen 歌词(包含逐字歌词、翻译、罗马音歌词,如果有)嵌入与下载,默认启用
- 下载列表菜单新增歌曲添加弹窗,允许将所选歌曲的在线版本添加到收藏列表 (#2537)
### 修复
- 尝试修复进度为0时仍然显示下载完成的问题 (#2471)
- 修复TX源搜索失败 (#2575 @Folltoshe)
- 修复MG源歌单加载失败
- 修复MG源评论加载失败
### 变更
- 调换「歌词翻译」与「歌词罗马音」的位置,现在歌词罗马音在歌词翻译的上方展示
*若你想要恢复以前的行为,可以开启「调换歌词翻译与歌词罗马音位置」选项*
- 更新代理配置规则,现在不启用代理时,图片、音频加载将不再走系统代理 (#2382 @Folltoshe)
- 字体设置可以最多设置两种字体([any-listen#82](https://github.com/any-listen/any-listen/issues/82))
### 其他
- 更新 Electron 到 37.6.0
### File MD5
```
CB35026B179E1E0DDE022DC5B5BD8ACE lx-music-desktop-v2.12.0-arm64-Setup.exe
B5E5A769FCE98AA51B6B21DC55038B9C lx-music-desktop-v2.12.0-x64-Setup.exe
B184520D8A153D7FE72A084820EC51D4 lx-music-desktop-v2.12.0-win_arm64-gr
10 downloads
v2.11.0
May 1, 2025### 新增
- 新增「快进/快退5秒」自定义快捷键设置(#2289)
- 新增「设置 → 桌面歌词设置 → 暂停时提高歌词透明度」设置,默认启用(#2294)
### 修复
- 修复 Windows 下桌面歌词最小高度与宽度设置问题(#2244)
- 修复 Windows 下界面缩放后移动桌面歌词会改变歌词窗口大小的问题(#2244)
- 修复 tx 歌单搜索名字、描述出现乱码的问题(#2250)
- 修复本地 FLAC 文件内嵌歌词无法读取的问题
- 修复潜在播放暂停的问题
- 修复 kw 歌单详情出现打开失败的问题(#2317)
- 修复 kg 热门评论无法获取的问题
- 修复桌面歌词被遮挡时会被暂停的问题(#2320)
- 修复 kg 歌单打开失败的问题(thanks @Folltoshe)
### 优化
- 允许更小的桌面歌词窗口宽度
- 允许拖动桌面歌词控制栏空白处移动歌词窗口(#2280)
- 优化「自定义源管理」对话框在小窗口下的布局(#2247, @3gf8jv4dv)
- 优化软件文案编排(#2259, #2266, #2269, #2296, @3gf8jv4dv)
### 变更
- 我的列表-歌曲菜单中的 歌曲换源 功能从之前的类似软连接的形式改成替换歌曲的形式,也就是说,现在该功能相当于快速在线搜索歌曲,确认换源后将自动将原来的歌曲删除再将选择的歌曲插入被删除歌曲的位置。
### 其他
- 更新项目文档(@3gf8jv4dv)
- 更新 Electron 到 35.2.2
### File MD5
```
22AFA1843573C95FD5661727B8936FF0 lx-music-desktop-v2.11.0-arm64-Setup.exe
3B73BF3A9CFB622CD7D20746E50FB763 lx-music-desktop-v2.11.0-x64-Setup.exe
1CAD8058EF1BD546ADE9ED3E56CA6F06 lx-music-desktop-v2.11.0-win_arm64-green.7z
3BF1F9F30ECAEC35F1DB2B0EF67E3889 lx-music-desktop-v2.11.0-win_x64-green.7z
D103F91C409D8C7727C79B416FC3FED8 lx-music-desktop-v2.11.0-win7_x64-Setup.exe
41A80C84E44C0AA15833A52C31965741 lx-music-desktop-v2.11.0-win7_x64-green.7z
50FD7528CA3
10 downloads
v2.10.0
Jan 26, 2025落雪祝大家新年快乐!
### 关于之前提到的新项目
新项目我取名叫 Any Listen,希望它能像它的名字一样让我们能到处任意听歌。
经过一年多的开发,因各种原因,实际进度比预期的慢,但还是赶在年前发布了第一个web服务预览版,第一个版本仅支持播放服务器上的歌曲,扩展功能暂时未能开放,但已趋于完成,一两个月内可以搞定。
目前的版本仅是“能用”的状态,因时间关系,部分UI未能重新设计,但后面会继续完善。
该项目目前的目标用户是拥有自己服务器且上面存储有歌曲的人使用。
项目刚发布,文档未能完善,遇到使用问题或有任何建议欢迎提 issue 交流,
项目地址: https://github.com/any-listen/any-listen
---
*感谢 @3gf8jv4dv 对 LX 系列项目翻译、文档等文案的大幅修订优化。*
### 不兼容性变更
Linux 系统至少需要 `GLIBC_2.29` 版本才能运行。
由于将 Electron 升级到 v32.x,原生库的编译被限制到不低于 C++ 20,试了几次无法在 docker 镜像 `node:16` 安装 gcc-10,最终将构建使用镜像更新到 `node:18`。
### 新增
- 新增下载的歌曲按列表名分组的功能,默认关闭,可以通过「设置 → 下载设置 → 将文件保存到以对应列表命名的子目录中」启用(#2145)
- 新增托盘图标样式「跟随系统亮暗模式」设置,可以在「设置 → 其他」里启用 (#2016)
- 支持本地同名 `.krc` 格式歌词文件的读取(#2053)
- 开放 API 新增播放器播放/暂停、切歌、收藏当前播放歌曲等接口调用,详情看文档「开放 API 服务」部分(#2077, @14Kay)
### 优化
- 优化正常播放结束时的下一首歌曲播放衔接度,在歌曲即将结束播放时将预获取下一首歌曲的播放链接,减少自动切歌时的等待时间(#2126)
- 优化歌曲换源机制,提升换源正确率
- 优化 Windows 平台上桌面歌词窗口大小调整机制,改用原生的窗口调整方式(#2137)
- 修正搜索歌曲提示框文案(#2050)
- 优化播放详情页 UI,修复「歌曲名」「艺术家」等文字过长时被截断的问题(#2049)
- Scheme URL 的播放歌曲允许更长的专辑名称
- 播放本地歌曲时,将优先尝试读取本地同名 `.jpg` 或 `.png` 图片作为播放封面显示,若文件不存在则从音频文件内读取,最后再尝试使用在线图片(#2096)
- 客户端模式的同步服务连接允许重定向 5 次(#2109)
- 更新软件默认使用的字体,修复 macOS Sequoia (15) 上界面出现乱码的问题(#207
10 downloads
v2.9.0
Aug 24, 2024### 新增
- 新增 设置-播放设置-是否将歌词显示在状态栏 设置,默认关闭,该功能只在 MacOS 下可用(#1940)
- 新增设置-播放详情页设置-延迟歌词滚动设置(#1985)
- 新增鼠标在音量按钮使用滚轮时可以调整音量大小的功能(#2000)
- 新增设置-下载设置-同时下载任务数设置(#1498)
- 新增 我的列表-歌曲右击菜单-歌曲换源 功能,换源后下次再播放该列表的该歌曲时将优先尝试播放所选源的歌曲,该功能允许你手动指定来源以解决自动换源失败或者换源不准确的问题
### 优化
- 优化侧栏图标显示,修复图标可能被裁切的问题(#1960)
- 托盘图标添加当前播放歌曲名字显示
- 优化本地歌曲内嵌封面过大时的加载方式
- 将下载歌曲的歌手信息中的分隔符从 `、` 替换为 `;` 以确保音乐元数据在写入时的兼容性和一致性(#1989 @qnnp-me)
### 修复
- 修复 MacOS 下点击 dock 右键菜单的退出按钮时,程序没有退出的问题(#1923)
- 修复 OpenAPI 的 `lyricLineAllText` 在切换到无歌词的音乐时内容没有更新的问题(#1925)
- 修复切换音源时可能出现切换死循环的问题
- 尝试修复某些情况下播放音频时,处于播放状态但是进度条不走的问题
- 修复程序目录路径存在 `#` 或 `%` 时,自定义源、托盘等图标异常的问题(#1997)
### 变更
- 简化了应用退出行为,据测试,现在 linux 下,若启用了托盘,dock 右键菜单的 退出、关闭所有 之类的功能将不再退出程序,需改用托盘的退出按钮退出程序
- 现在如果在设置或者启动参数配置了代理服务,那么应用内的图片、音频加载,歌曲下载也将走代理
### 其他
- 更新 electron 到 v30.4.0
### File MD5
```
F561F7D2EE3983D3DAEFDEB2ECBAB500 lx-music-desktop-v2.9.0-arm64-Setup.exe
3D4446C01D4D7102765185DE0972F0BE lx-music-desktop-v2.9.0-x64-Setup.exe
E05CC10E290AEF0E69420064B4FC73EF lx-music-desktop-v2.9.0-win_arm64-green.7z
BDA955CBCB193B979F42E4C22E708B96 lx-music-desktop-v2.9.0-win_x64-green.7z
DAD74306D379EDB0AD655A4BDD1B4287 lx-music-desktop-v2.9.0
10 downloads
v2.8.0
Jun 1, 2024
我们发布了关于 LX Music 项目发展调整与新项目计划的说明,详情看: https://github.com/lyswhut/lx-music-desktop/issues/1912
### 新增
- 新增 设置-播放设置-使用设备能处理的最大声道数输出音频 设置(未启用时固定为2声道输出),由于这用到高级音频API,考虑到在某些设备上的兼容问题,默认禁用(#1873)
- 允许添加 `m4a`、`oga` 格式的本地歌曲到列表中(#1864)
- 开放API支持跨域请求(#1872 @Ceale)
- Scheme URL API新增 `music/searchPlay` 支持,用于搜索并播放指定的歌曲名字,详细入参请阅读 Scheme URL 支持文档(#1886)
### 优化
- 优化白色托盘图标显示,修复windows下托盘图标不清晰的问题(#1842)
### 修复
- 修复存在多级弹窗时的背景显示问题
- 增大在线导入自定义源文件的大小限制问题(#1857)
- 修复Mac下窗口出现残留阴影的问题,这解决了Mac下桌面歌词出现残留阴影的远古bug,感谢 @zclorne (#1869, Thanks @zclorne)
- 增大在线导入自定义源文件的大小限制,解决某些音源无法导入的问题(#1857)
- 修复Mac下即使开启了托盘, `cmd+w` 仍会中断播放的问题(#1844)
- 修复播放详情页的歌词无法使用触碰拖动的问题(#1865)
- 修复与优化繁体中文、英语翻译显示(#1845)
- 修复歌曲时文件名过长导致歌曲无法下载的问题(#1877)
- 修复文本提示气泡在内容过长时,文本未被换行而被截断的问题
- 修复翻页按钮栏切页按钮只显示前几页的问题
### 变更
- 设置-播放设置-优先播放320k音质选项改为“优先播放的音质”,允许选择更高优先播放的音质,如果歌曲及音源支持的话(#1839)
### 开放API变更
- `/status` 的入参现在与 `/subscribe-player-status` 保持一致
- `/status` 新增 `filter` 入参用于过滤返回的字段,并内置了默认值,与之前相比默认不再返回 `picUrl`
- `/status` 及 `/subscribe-player-status` 的可用字段名添加了 `lyricLineAllText`,它对应的值是当前句歌词及扩展歌词文本(扩展歌词包含翻译、罗马音等,按换行符分割)
详情看开放API接入文档
### 其他
- 更新 electron 到 v28.3.3
### File MD5
```
887811BEDB
10 downloads
v2.7.0
Apr 14, 2024### 新增
- 主题编辑器添加“深色字体”选项,启用后将减少字体颜色梯度,各类字体(正文、标签字体等)颜色将更接近,这有助于解决创建全透明主题时可能出现的字体配色问题(#1799)
- 新增在线自定义源导入功能,允许通过http/https链接导入自定义源
- 新增HTTP开放API服务,默认关闭,该服务可以为第三方软件提供调用LX的能力,可用API看[说明文档](https://lyswhut.github.io/lx-music-doc/desktop/open-api)(#1824)
- 托盘菜单新增播放、切歌、收藏控制
- 添加当前软件版本所对应的代码提交版本、提交时间的显示,可到设置-版本更新查看
### 优化
- 主题设置默认折叠其他主题以优化进入设置界面时的性能
- 不再丢弃kg源逐行歌词(@helloplhm-qwq)
- 支持kw源排行榜显示大小(revert @Folltoshe #1460)
- 托盘菜单添加多语言支持(#1802)
- 优化本地歌曲换源匹配机制
### 修复
- 修复某些情况下歌曲加载时间过长时不会自动跳到下一首的问题
- 修复mg歌词在某些情况下获取失败的问题(#1783)
- 修复mg歌单搜索(@helloplhm-qwq)
- 修复kg最新评论无法获取的问题(@helloplhm-qwq)
- 修复更新超时弹窗在非更新阶段意外弹出的问题(#1797)
- 修复网络代理设置没有对自定义源的网络请求生效的问题(#1814)
### 移除
- 移除未使用的网络代理设置用户名、密码设置,实际上在 v1.20.0 起这两个设置就没有在被内部使用
### 其他
- 更新 electron 到 v28.3.0
### File MD5
```
C2EADEBFFAC6AA83F63C39F35B3A3AFD lx-music-desktop-v2.7.0-arm64-Setup.exe
26C847E2622F307F4C32BD047FB46361 lx-music-desktop-v2.7.0-x64-Setup.exe
69EC1BF2312C7016AFCA517C4B2E0FE2 lx-music-desktop-v2.7.0-win_arm64-green.7z
5ED12D746C75D50C975B52EE29C11728 lx-music-desktop-v2.7.0-win_x64-green.7z
ACFC2940604E4C068FF5E32A86965AC6 lx-music-desktop-v2.7.0-win7_x64-Setup.exe
5AB9DC84752437C9E9879D
10 downloads
v2.6.0
Feb 1, 2024提前祝大家新年快乐!
更新前需要注意:
由于自定义源的调用方式变更,可能会导致某些第三方源停止工作,如果出现这种情况,你需要将LX回退到 v2.5.0
### 新增
- 若自定义源初始化失败,将会出现弹窗提示初始化失败的详情
- 添加win7_x64架构的安装版安装包构建
- 新增播放歌曲时阻止电脑休眠,默认启用,可到设置-播放设置关闭(#1563)
### 优化
- 更新zh-tw翻译
- 自定义源列显示源版本号、作者名字
- 优化列表全选机制,修复列表未获得焦点时仍然可以全选的问题
- 优化搜索框交互逻辑,防止鼠标操作时意外搜索候选列表的内容
- 添加对wy源某些歌曲有问题的歌词进行修复
- 改进本地音乐在线信息的匹配机制
- 优化任务下载状态显示,现在下载时若数据传输完成但数据写入未完成时会显示相应的状态
- 添加对下载歌曲时封面图片大小的控制处理(#1609)
- 添加创建同名列表时的二次确认(#1621)
### 修复
- 修复备份文件无法导入json格式的问题
- Windows、MacOS平台下的字体列表取消使用原生方式获取以修复某些字体应用后无效的问题(#1596)
- 修复亮暗主题自动切换功能无效的问题(#1697)
- 修复 MacOS 平台在 Finder 打开文件或目录时应用卡死的问题(#1684)
- 修复下载模块在数据写入速度较慢的情况下出现任务及文件异常的问题
- 修复临时列表变更会意外触发同步的问题
- 修复最小化后再隐藏窗口时,托盘菜单的显示主界面功能异常的问题
### 变更
- 播放歌曲时默认会阻止系统进入休眠状态,若你不行软件阻止系统休眠,可以到设置-播放设置取消勾选“播放歌曲时阻止电脑休眠”设置
### 其他
- 移除所有内置源,由于收到腾讯投诉要求停止提供软件内置的连接到他们平台的在线播放及下载服务,所以从即日(2023年10月18日)起LX本身不再提供上述服务
- 更新 electron 到 v25.9.8
- 更新许可协议的排版,使其看起来更加清晰明了,更新数据来源原理说明
### 自定义源的不兼容变更与新增内容(源开发者需要看)
自定义源的调用方式已改变:
- 为了与移动端的调用方式统一,不再推荐使用 `window.lx` 对象(移动端无`window`对象),改用 `globalThis.lx`
- `inited` 事件不再需要传递 `status` 属性,脚本运行过程中,在成功调用 `inited` 事件之前的任何首次未捕获的错误都将视为初始化失败,所以现在若想人为让脚本初始化失败,直接抛出一个错误即可
- 新增 `globalThis.lx.env` 属性,桌面端环境固定为 `
9 downloads
v2.5.0
Sep 28, 2023落雪提前祝大家中秋快乐~🥮😘!
### 不兼容性变更
- 由于微软及Electron即将结束对 Windows 7、Windows 8 的支持,所以从这个版本起,LX的默认 Windows 版也不再支持这些版本的系统,但考虑到仍然有许多人使用 Windows 7,我们特别构建了能在 Windows 7 上使用的免安装版(文件名带win7),需要注意的是这个版本将缺乏安全更新,若非必要情况,不要使用该版本
- 由于微软在 Windows 10 2004版本已删除对32位的OEM支持,所以在这个版本起,LX的默认 Windows 版已不再提供32位的支持
- 更改构建的文件名格式,主要修改linux下deb、rpm文件命名格式
### 新增
- 新增Scheme URL对播放器的控制操作,新增的操作包含 播放、暂停、下一首、上一首等,详情看Scheme URL文档
### 优化
- 通过歌曲菜单添加不喜欢歌曲时需要二次确认防止手抖
### 修复
- 修复音频输出设备设置在重启软件后被重置的问题(#1568)
- 修复更换语言设置后源名称未更新的问题
- 修复点击搜索、排行榜等在线列表歌曲右键菜单歌曲详情页会意外将该歌曲添加不喜欢的问题
### 其他
- 更新 electron 到 v25.8.3
注:从v2.5.0起,LX的默认 Windows 版不再支持 Win 7、8 系统,但考虑到仍然有许多人使用 Win 7,我们特别构建了能在 Win 7 上使用的免安装版(文件名带win7),需要注意的是这个版本将缺乏安全更新,若非必要情况,不要使用该版本
### File MD5
```
84E9DFAA1DBFAA53E7CDD270029C0BFA lx-music-desktop-v2.5.0-arm64-Setup.exe
E58F819831DF9F0584F05AB12053DD1A lx-music-desktop-v2.5.0-x64-Setup.exe
E47EEB13DB6DDB7A9E606977624A528D lx-music-desktop-v2.5.0-win_arm64-green.7z
5600F7E6D3C2579CF9B5574501DEEFE3 lx-music-desktop-v2.5.0-win_x64-green.7z
A1A0F1444A434D8DCCE9CFA9787D0DC2 lx-music-desktop-v2.5.0-win7_x64-green.7z
8BF9904CE565E9EA34409F15BB47BBCD lx-music-desktop-v2.5.0-win7_x86-green.7
9 downloads