企业官网建设流程全解析

LX Music：免费多音源聚合播放器完整指南

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

一首歌在这个平台下架了，换下一个客户端再找，实在费劲。LX Music 是一个基于 Apache License 2.0 协议开源的多音源聚合播放器，把酷我、酷狗、QQ 音乐、网易云、咪咕等平台的在线音源收进同一个搜索框，支持 Windows、macOS 与 Linux。想免费把歌找全、数据自己管的人，可以往下看。

先跑起来

1. 直接去 release 页面下对应平台的安装包：Windows 是 .exe，macOS 是 .dmg，Linux 有 deb、rpm、AppImage 可选，双击安装即可。
2. 想体验最新改动就自己构建，环境需要 Node 22 及以上。
3. 克隆仓库、装依赖、启动，三步走完就能看到主界面。

git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install npm run dev

第一次启动的三件事

官方文档里提过一句：默认设置并不以新手友好为目标。所以首启建议先过一遍设置：

1. 播放音质：设置 → 播放，player.playQuality默认是 128k，按你的网络改成 320k 或无损，声音才配得上歌。
2. 下载：设置 → 下载，默认是关闭状态、保存路径指向桌面，打开开关并指一个专门目录，下好的歌才不会和工作文件混在一处。
3. 主题：设置页里默认套的是"绿意盎然"，挑一个顺眼的换上，界面颜色会整体跟着变。
4. 可选：设置 → 桌面歌词，默认关闭，想最小化主窗口还能看歌词的话再开。

上手体验

歌到底在哪找全

在顶部搜索框输入歌名，多个平台的结果合并在一页里，同一首歌能按平台和音质档位各选一份。某家下架了，另一家的音源还能顶上，命中率比单平台客户端高。这套逻辑集中在 src/renderer/utils/musicSdk/，每个平台一个子目录，搜索、歌单、歌词接口各自封装。

歌词跟到桌面上

在"设置 → 桌面歌词"开启后，会弹出独立于主窗口的歌词窗，横排竖排、字体字号、已唱未唱两种行颜色、透明度都能在设置里调。开着主程序工作时，把歌词窗固定在屏幕角落，滚动跟随当前行，不用切窗口。它对应 src/renderer-lyric/ 目录，单独打包运行。

换个脸就换套皮

内置主题按统一格式定义在 src/common/theme/ 目录：index.json里存每个主题的名称、明暗模式和整套 CSS 颜色变量，背景图放在同目录的images/下。照同样格式自建一份、换张背景图，就是一套新皮肤。

进阶：解锁更多可能

🎛️开放 API：v2.7.0 起，在"设置 → 开放 API"启用后，LX Music 会在本机启动一个 HTTP 服务（默认端口 23330）。发个/play就播放，/pause暂停，/status能拿到当前歌曲、进度和歌词行。几行脚本或定时任务，就能把播放器接进自动化流程。

🔄数据同步服务：v2.2.0 起支持自建同步服务，客户端与服务端代码都在 src/main/modules/sync/ 下。有台闲置服务器或 NAS，部署上去之后，多台电脑的歌单、收藏就能保持一致，数据全程在自己手里。

源码地图

技术栈是 Electron + Vue 3 + TypeScript，webpack 构建，本地数据用 better-sqlite3 存储。目录职责很清晰：src/main/是主进程，窗口、托盘、热键以及开放 API、同步等模块都挂在modules/下；src/renderer/是主界面；src/common/放主渲染两端共享的设置与类型。想参与贡献，切到dev分支开发、PR 也提到dev；新功能建议先建 Issue 确认必要性，修 bug 的 PR 附上复现方式，合并会顺很多。

哪类人会用到它

• 如果你歌散在多个平台，想一个入口搜全
• 如果多台设备要同步歌单，又不想数据放公网
• 如果想用脚本或定时任务遥控播放器
• 如果想通读一份完整的 Electron + Vue 3 应用源码

一个搜索框把歌找全，数据攥在自己手里——这就是 LX Music 给出的"找得到、免费听、自己管"三件套。

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