LX Music：五大音源装进一个搜索框，免费听歌不折腾
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
在酷我、酷狗、QQ 音乐、网易云、咪咕之间切来切去，同一首歌要翻五个 App，高音质还得开会员。LX Music 桌面版把五个音源合并进同一个搜索框，输入关键词，结果按源直接列出。
一句话定位：免费开源的多音源音乐播放工具，面向想白嫖多音源的新手。
- 技术栈：Electron + Vue 3 + TypeScript，本地数据用 better-sqlite3 存储
- 许可证：Apache License 2.0，完全免费
- 支持平台：Windows 7 及以上、macOS、Linux（AppImage / deb / rpm）
左侧导航是列表与设置入口，底部为播放详情区
🚀 从下载到第一首歌
选对安装包，别装错架构
- Windows 分安装版（setup）与绿色版（green）：前者支持自动更新，长期使用选安装版。
- macOS 提供 .dmg，Apple Silicon 与 Intel x64 分开，按 CPU 架构选。
- Linux 提供 AppImage、.deb、.rpm、.pacman，按发行版各取所需。
- ⚠️ 坑：安装版当初以管理员身份安装 → 自动升级时"卸了旧版装不上新版" → 重装时选"为当前用户安装"，放在用户目录下。
首次启动：三处设置一次调到位
- 音乐源：播放链接依赖设置里的"自定义源"脚本，先确认脚本就位可用；所有歌都提示"请求异常"，多数是脚本失效或网络问题，不是软件故障。
- 下载路径：默认存桌面，建议改到独立分区目录，路径在
设置 → 下载 → 更改路径。 - 桌面歌词：打算常用就提前在
设置 → 桌面歌词里开启，把字体和排版定好。
跑通第一次搜索
- 顶部搜索框输入关键词，结果带封面、歌手、音质（128k / 320k / flac），搜索框左侧下拉可切换当前音源。
- 单击歌曲即试听；按住
Ctrl或Shift可多选，右键"添加到我的列表"再整批播放。 - ⚠️ 坑：排行榜、歌单、搜索全部加载不出来 → 大概率是
设置 → 网络里的代理配错 → 先清空或改正代理再试。
🎧 功能拆解——按使用深度分三层
日常高频
- 五源聚合搜索：同一关键词按源分别检索，某源查不到就换源再试 → 顶部搜索框 → 音源下拉。
- 桌面歌词：独立歌词窗口，支持字体选择、逐行播放样式、位置锁定与置顶 →
设置 → 桌面歌词；播放栏 LRC 按钮上右键可快速锁定位置。 - 离线下载：可选音质、下载 LRC 与封面，歌词还能内嵌进文件，默认并发 3 个任务 → 列表右键 → 下载。
- 播放队列："稍后播放"优先级最高，按"下一曲"时先消耗它；注意直接点击其他列表切歌会清空该队列。
进阶效率
- 音效处理：内置均衡器、卷积混响（模拟厅堂、房间声场）、音调偏移与 0.5～2 倍播放速度，集中在播放栏的音效入口。
- 批量操作：
Ctrl+A全选后右键，可批量添加、批量下载。 - 命令行快捷启动：启动参数
-search="歌名"、-play="type=songList&source=myList&name=列表名"放进快捷方式，双击开软件即播。 - Scheme 调用：
lxmusic://协议支持从浏览器等外部场景发起搜索与播放。
扩展与集成
- 开放 API：
设置 → 开放 API启用后，本地起一个 HTTP 服务，默认端口23330，第三方脚本即可读状态、做控制。 - 数据同步：v2.2.0 起提供独立同步服务组件，自行部署后多端私有化同步；软件内置的局域网同步默认端口
23332，方便与移动版在同一个路由器下同步列表。
🔧 把工具调成自己的
主题库内置多套背景，也支持自定义导入，在设置 → 主题设置中切换：
内置水墨主题，适合喜欢留白风格的桌面
月夜主题，适合深夜听歌场景
快捷键分"本地"（窗口聚焦时生效）与"全局"（系统级，默认关闭）两档，默认绑定如下：
| 按键 | 作用域 | 功能 |
|---|---|---|
Mod+F5 | 本地 | 播放 / 暂停 |
Mod+← / Mod+→ | 本地 | 上一曲 / 下一曲 |
F1 | 本地 | 聚焦搜索框 |
Mod+Alt+F5 | 全局 | 播放 / 暂停（默认关） |
Mod+Alt+0 | 全局 | 显示 / 隐藏桌面歌词（默认关） |
Mod在 Windows/Linux 是Ctrl，macOS 是Command；两档按键均可在设置 → 快捷键中重新映射。
数据与配置按系统存在以下目录，迁移时把这个目录整体拷走即可：
| 系统 | 默认存储目录 |
|---|---|
| Windows | %APPDATA%/lx-music-desktop |
| macOS | ~/Library/Application Support/lx-music-desktop |
| Linux | ~/.config/lx-music-desktop |
Windows 下若程序目录里存在portable文件夹，LX Music 会自动改用它存放数据，配合绿色版可以整套拷进 U 盘带走。
🩺 对号入座排障表
- 所有歌曲提示"请求异常"或
EAI_AGAIN→ 网络/DNS 无法访问接口服务器 → 切移动热点验证，DNS 改为223.6.6.6，并清空软件内代理。 - 搜索正常但播放不出来或歌不对→ 自定义源脚本过期 → 更新源脚本，或在设置中切换其他接口。
- 下载报
ENOENT: ... mkdir→ 下载目录无读写权限 →设置 → 下载中更换路径。 - macOS 提示"已损坏"→ 未签名应用被系统隔离 → 终端对 .app 执行
sudo xattr -rd com.apple.quarantine移除隔离属性。 - Windows 10/11 窗口不显示→ GPU 沙箱兼容问题 → 快捷方式加启动参数
--disable-gpu-sandbox。
🤝 给想动手的人
项目欢迎 PR，两条约定：新功能先开 Issue 确认必要性；修 bug 的 PR 要附重现方式与修复前后说明。
开发环境最低要求：Node.js ≥ 22，npm ≥ 8.5.2。
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop git checkout dev核心代码都在src/下：主进程（窗口、IPC、同步服务、开放 API）在src/main/，界面在src/renderer/，桌面歌词窗口在src/renderer-lyric/，五个音源的接口实现集中在src/renderer/utils/musicSdk/，想加新音乐源从对应目录读起。
回到开头那个多平台横跳的场景：现在打开 LX Music，一个搜索框加一个音源下拉，基本就能覆盖找歌、试听、下载的全流程。项目定位是技术研究，使用中产生的版权数据应及时清理，长期使用建议支持正版。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
