LX Music 桌面版使用指南：免费多音源播放器，5 大音源装进一个搜索框，0 元听歌不折腾

LX Music 桌面版使用指南：免费多音源播放器，5 大音源装进一个搜索框，0 元听歌不折腾

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

把同一首歌在几个 App 之间来回找、为高音质掏会员费，这种消耗可以省掉。LX Music 桌面版是一款免费开源的多音源音乐播放器，把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源聚合进同一个搜索框，搜索、试听、下载在一个窗口内完成。它用 Electron + Vue 3 + TypeScript 构建，本地数据走 better-sqlite3，采用 Apache License 2.0 协议，覆盖 Windows 7 及以上、macOS 和 Linux。这篇指南按"装软件 → 调设置 → 上手播放 → 效率玩法 → 出问题怎么办"的顺序讲，每步都给出具体入口。

先装对：Windows、macOS、Linux 的安装包怎么选

Windows 分两种形态：安装版（setup）和绿色版（green）。区别在于自动更新——安装版能走更新通道，绿色版不能。打算长期用就选安装版；只是临时尝鲜，绿色版解压即用。

macOS 只提供 .dmg，但按 CPU 架构分两个包：Apple Silicon 选 arm64，Intel x64 选 x64，装错架构会白忙一场。

Linux 提供 AppImage、.deb、.rpm、.pacman 四种格式，按发行版取对应的一种即可，AppImage 是通用兜底方案。

Windows 安装身份会决定日后的升级体验。如果安装时选择了"为所有用户安装"（即以管理员身份），后续自动升级可能出现"旧版卸载了、新版装不上"的卡死状态。判断依据很简单：升级日志显示卸载成功但安装失败。解法是重新安装时勾选"为当前用户安装"，并把程序放在当前用户目录下，避开系统目录的权限差异。

第一次打开：三处设置决定后面顺不顺

软件默认配置偏"老手向"，第一次启动建议先把下面三处过一遍。

音源：所有播放请求的命门

播放链接依赖"自定义源"脚本来解析，首次启动先确认源脚本就位且能正常返回。典型症状是所有歌曲都提示"请求异常"——注意，这大概率不是软件坏了，而是脚本失效或当前网络不通，先别急着重装。

下载路径：别留在桌面

默认下载位置是桌面。建议改到一个独立分区或专门的目录，理由有二：一是桌面路径容易受 OneDrive 之类同步工具干扰；二是权限问题会直接暴露成报错。后续如果下载任务抛出ENOENT: no such file or directory, mkdir，判断依据就是目标目录没有读写权限，回到设置 → 下载里换路径即可。

桌面歌词：提前开比事后找快

如果确定要用独立歌词窗口，直接在设置 → 桌面歌词里开启，顺手把字体和排版定好。平时切换用全局快捷键（见下文），播放栏 LRC 按钮上右键还能快速锁定歌词位置。

顺手检查代理配置

设置 → 网络里的代理如果配错（比如残留了一个已失效的代理地址），整个软件会直接断网：排行榜、歌单、搜索全部加载不出来。排查网络问题前，先确认这里没有被误改。

搜一首歌：从关键词到听完整首的完整路径

顶部搜索框输入关键词，右上角下拉切换当前音源。结果列表带封面、歌手和音质信息（128k / 320k / flac）。某个源查不到时，换个源再搜一次，五个源互相兜底，这就是聚合的价值。

播放交互的默认逻辑和新用户习惯不太一样，值得提前知道：

• 单击歌曲 = 试听这一首；
• 想连播多首，按住Ctrl（不连续选）或Shift（连续选）多选，操作逻辑类似 Windows 文件选择，然后右键添加到"我的列表"再播放；
• 你点过的歌会自动进试听列表，适合快速过一遍再决定留下哪些；
• Ctrl+A全选后右键，可批量添加、批量下载。

"稍后播放"队列有两条规则：它是优先级最高的队列，点"下一曲"时优先消耗其中内容；但只要你直接点击其他列表里的歌曲切歌，这个队列会被清空。想用它攒歌，就别用"点歌切歌"的方式换曲。

日常用法：下载、音效与桌面歌词

离线下载

列表右键 → 下载。可选项目：音质、是否下载 LRC、是否下载封面、是否把歌词内嵌进文件。任务默认 3 个并发，批量下载时不用盯着。下载目录相关的所有选项集中在设置 → 下载。

音效面板

播放栏的音效入口里集中了几项处理能力：均衡器（多段频率调节）、卷积混响（内置厅堂、房间等声场模拟，源码里的冲激响应素材在 src/renderer/assets/medias/filters/）、音调偏移，以及 0.5～2 倍的播放速度。对音源本身音质不满意时，混响和均衡器能救回一部分听感。

桌面歌词窗口

独立窗口，支持字体选择、逐行播放样式、位置锁定与始终置顶。入口在设置 → 桌面歌词；播放中想临时固定位置，右键播放栏 LRC 按钮即可。歌词窗口的界面与逻辑在 src/renderer-lyric/ 下，渲染与主窗口完全解耦。

快捷键：本地与全局两档

本地键在窗口聚焦时生效，全局键是系统级（默认关闭，开启后切到别的窗口也能控制）。默认绑定如下：

Mod在 Windows/Linux 上就是Ctrl，macOS 上是Command。全部按键可以在设置 → 快捷键里重新映射。

效率玩法：命令行、Scheme 与开放 API

快捷方式带参数启动

在桌面快捷方式的目标后面追加启动参数，双击就能直达内容：

• -search="歌名"：启动即搜索；
• -play="type=songList&source=myList&name=列表名"：启动即播放指定列表。

另外lxmusic://Scheme 支持从浏览器等外部场景发起搜索与播放，配合网页环境使用很顺。

开放 API：让第三方脚本控制播放器

在设置 → 开放 API 里启用后，软件本地起一个 HTTP 服务，默认端口 23330。两条最常用的接口：

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

/subscribe-player-status接口走 SSE 实时推送歌词行、进度等字段，拿它做一个桌面歌词挂件或状态小组件相当方便。相关实现位于 src/main/modules/openApi/。

主题与数据目录：换皮和备份都在这

主题库内置多套背景，也支持自定义导入，入口在设置 → 主题设置。下面是仓库里自带的几张：

数据目录（备份、迁移时要用）：

Windows 上有个便携特性：程序目录里如果存在名为portable的文件夹，软件会自动改用它存数据。配合绿色版，整套配置可以拷进 U 盘带走。

出问题时的排查顺序

按"症状 → 判断依据 → 解法"对号入座：

• 症状：所有歌曲提示"请求异常"或EAI_AGAIN。判断：网络或 DNS 访问不到接口服务器，与软件本身无关。解法：先切手机热点验证；DNS 改成223.6.6.6或8.8.8.8；同时确认软件内没有配置错误的代理。

• 症状：搜索正常，但播放不出或放出来的歌不对。判断：自定义源脚本过期，接口行为变了。解法：更新源脚本，或在设置中切换到其他接口。

• 症状：下载任务报ENOENT: ... mkdir。判断：下载目录没有读写权限。解法：设置 → 下载中更换路径。

• 症状：macOS 打开应用提示"已损坏"。判断：未签名应用被系统加了隔离属性。解法：终端执行sudo xattr -rd com.apple.quarantine（针对该 .app 路径）移除隔离。

• 症状：Windows 10/11 下窗口不显示。判断：GPU 沙箱兼容问题。解法：快捷方式追加启动参数--disable-gpu-sandbox；仍无效再逐个尝试-dha、--disable-gpu。

更多问题可以参考仓库自带的 FAQ.md。

想动手改：参与开发的最小路径

项目接受外部贡献，两条约定要遵守：新功能先开 Issue 确认必要性；修 bug 的 PR 必须附重现方式和修复前后说明。

开发环境最低要求：Node.js ≥ 22，npm ≥ 8.5.2。

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

在 dev 分支上开发并向 dev 提 PR。核心代码都在src/下，分工很清晰：主进程（窗口、IPC、同步服务、开放 API）在 src/main/，主界面在 src/renderer/，桌面歌词窗口在 src/renderer-lyric/，五个音源的接口实现集中在 src/renderer/utils/musicSdk/——想加新音乐源，从对应目录读起就对了。

数据同步方面：v2.2.0 起提供独立同步服务组件，自行部署可获得私有化多端同步；软件内置的局域网同步（默认端口 23332）则适合和移动版在同一个路由器下快速同步列表，实现在 src/main/modules/sync/。

最后说两句

回到开头那个多平台横跳的场景：一个搜索框加一个音源下拉，已经能覆盖大部分查找需求——这也是这个项目的核心价值，免费、完整、可自己扩展。但要清楚它的定位是技术研究，搜索和下载产生的版权数据要及时清理；长期使用的话，还是建议支持正版。

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