LX Music 桌面版：一个搜索框聚合五大音源，免费听歌下载不折腾

LX Music 桌面版：一个搜索框聚合五大音源，免费听歌下载不折腾

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

为了找同一首歌在三个音乐平台之间反复横跳、为了高音质还得开会员，这个痛点用 LX Music 桌面版可以一次解决：酷我、酷狗、QQ 音乐、网易云、咪咕五个音源放进同一个搜索框，搜索、试听、下载同屏完成，完全免费开源。

• 技术栈：Electron + Vue 3 + TypeScript，本地数据用 better-sqlite3 存储
• 许可证：Apache License 2.0（附带项目补充协议）
• 支持平台：Windows 7 及以上、macOS（Intel 与 ARM 分别打包）、Linux（AppImage / deb / rpm / pacman）
• 当前版本：v2.12.2

LX Music 桌面版主界面：顶部搜索框加音源切换，底部为播放控制区，搜索、试听、下载都在这里完成

如何安装 LX Music 桌面版并选对安装包

• Windows 有安装版（setup）与绿色版（green）两类，另有 x64 / x86 / arm 架构区分：长期用就选安装版，它支持自动更新；绿色版免安装、方便拷 U 盘，但自动更新不可用。
• macOS 选.dmg，注意区分 Apple Silicon 与 Intel x64 两个包，按自己 CPU 架构下载。
• Linux 按发行版选 AppImage、.deb、.rpm或.pacman。
• Mac 与 Linux 版都不支持自动更新，有新版时手动覆盖安装即可。

最容易卡住的一个坑：Windows 安装版如果当初以管理员身份装的，自动升级时可能出现"卸载了旧版但装不上新版"。解法是安装时选"为当前用户安装"、放在当前用户目录，不要选"为所有用户安装"。

首次启动必改的三处设置

• 音乐源：播放链接依赖设置里"自定义源"脚本返回的在线链接。如果所有歌都提示"请求异常"，多半是脚本失效或网络访问不了接口服务器，先切换其他接口或换网络验证，别急着怀疑软件本身。
• 下载路径：默认存到桌面，建议改到独立分区目录；播放音质默认是 128k，想在下载和试听时拿 320k / flac，记得顺手在设置里改掉。
• 桌面歌词：默认关闭，打算常用就提前在设置里开启，把字体、字号、置顶都调好，之后就不用翻找入口。

另外提醒一句：设置 → 网络里的代理如果配错，整个软件会直接无法联网，排行榜、歌单、搜索全部加载不出来，排查网络问题先看这里。

歌曲怎么找、怎么试听、怎么下载

找到歌：搜索框 + 音源下拉

顶部搜索框输入关键词，结果带封面、歌手与音质信息；右上角音源下拉在 kw / kg / tx / wy / mg（酷我、酷狗、QQ 音乐、网易云、咪咕）之间切换。某个音源查不到就换源再试，不用换软件。搜索框的候选项可以按上下方向键选中、回车直接搜。

试听与排队播放：先学会多选

• 单击歌曲是试听，点过的歌会自动收进试听列表，适合快速过一遍。
• 想连播多首：按住Shift连续选择、按住Ctrl不连续选择、Ctrl+A全选（操作逻辑类似 Windows 文件选择），然后右键添加到"我的列表"再播放。
• "稍后播放"是优先级最高的队列，点"下一曲"时优先消耗；注意直接点击其他列表切歌会把这个队列清空，这是新手最容易忽略的一点。
• 在"我的列表"里按Ctrl+F可在列表内搜歌，回车跳过去、Ctrl+回车跳转并播放。

离线下载：右键 → 下载

列表内右键即可下载，可选音质、是否下载 LRC、是否内嵌封面与歌词；默认并发 3 个任务、默认跳过已存在文件、文件名为"歌名 - 歌手"。批量操作时先Ctrl+A全选再右键，一次把整批歌下完。

三个值得开启的进阶能力：快捷键、开放 API、局域网同步

快捷键分两档，都能在设置里重新映射：

Mod在 Windows / Linux 是Ctrl，macOS 上对应Command。

开放 API：设置 → 开放 API 启用后（v2.7.0 起支持），本地起一个 HTTP 服务，默认端口23330，第三方脚本即可控制播放：

# 获取当前播放状态（歌名、进度、歌词行等） curl http://127.0.0.1:23330/status # 暂停播放 curl http://127.0.0.1:23330/pause

/subscribe-player-status用 SSE 实时推送歌词行、进度等字段，做桌面歌词挂件很省事。

局域网同步：设置 → 数据同步开启后，PC 端默认监听23332端口，手机移动版填上地址和端口就能在同一个路由器下同步列表（数据是明文传输，在受信任网络下用）；v2.2.0 起还有独立的同步服务组件，可自行部署成私有化多端同步。

另外两个小提效：启动参数-search="突然的自我 - 伍佰"开软件即搜、-play="type=songList&source=myList&name=列表名"开软件即播，写进快捷方式就行；lxmusic://Scheme 则支持从浏览器等外部场景调用搜索与播放。

数据目录在哪里、主题怎么换

备份或迁移时看这份表：

Windows 下若程序目录里存在portable文件夹（v1.17.0 起支持），会自动改用它存放数据，配合绿色版可以整套拷进 U 盘带走。

主题方面内置多套背景，水墨风这类意境皮肤和月夜风都有，在设置 → 主题设置中切换或自己编辑：

内置水墨主题背景，在设置 → 主题设置中一键切换

LX Music 桌面版无法播放、下载失败怎么修

按出现频率排，全部是"现象 → 原因 → 解法"：

• 所有歌提示"请求异常"或EAI_AGAIN→ 你的网络访问不了接口服务器（DNS 问题居多）→ 切手机热点验证；不行就把 DNS 改成223.6.6.6或8.8.8.8，改完重启软件。
• 搜索正常但播放不出来、或者播出来的歌不对→ 自定义源脚本过期 → 更新源脚本，或在设置里切换到其他接口。
• 下载报ENOENT: no such file or directory, mkdir→ 下载目录没有读写权限 → 设置 → 下载里换个路径。
• 排行榜、歌单、搜索全部加载不出→ 设置里的代理配错 → 先清空代理再试，同时看看有没有防火墙拦了软件。
• macOS 提示"已损坏"无法启动→ 未签名应用被系统隔离 → 终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app。
• Windows 10 / 11 窗口不显示→ GPU 沙箱兼容问题 → 给快捷方式加启动参数--disable-gpu-sandbox，无效再逐个换-dha、--disable-gpu试。

更多细节看仓库里的 FAQ.md，版本变化看 CHANGELOG.md。

如何参与 LX Music 桌面版开发

项目欢迎 PR，两条约定：新功能先开 Issue 确认必要性；修 bug 的 PR 要附重现方式和修复前后说明。开发环境最低要求 Node.js ≥ 22、npm ≥ 8.5.2，在dev分支开发并提交：

git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

代码结构不复杂：主进程（窗口、IPC、同步服务、开放 API）在src/main/，界面在src/renderer/，桌面歌词窗口在src/renderer-lyric/；五个音源的接口实现集中在 src/renderer/utils/musicSdk/ 下，想加新音源从对应目录读起就行。

写在最后

回到开头那个多平台横跳的场景：一个搜索框加一个音源下拉，已经能覆盖大部分找歌需求；想留住的歌，下载下来带走。最后提醒一句，项目定位是技术研究与学习，使用中产生的版权数据请及时清理，长期使用建议支持正版。

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop