企业官网建设流程全解析

LX Music 完整指南：免费开源音乐下载，一个搜索框搜遍五大音源

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

在三个平台之间反复横跳，还是找不到同一首歌？换个平台听高清版，又得花钱开会员。LX Music 是一款免费开源的多音源音乐播放器，酷我、酷狗、QQ 音乐、网易云、咪咕一次聚合，搜索、试听、下载同屏完成。

📦 30 秒看懂 LX Music

结论先行：零成本搭一个自己的多音源音乐库，用它就够了。

• 技术栈：Electron（把网页应用打包成桌面程序的框架）+ Vue 3 + TypeScript，本地数据存在 better-sqlite3（一个嵌入式 SQLite 数据库文件）里
• 许可证：Apache License 2.0，完全免费
• 支持平台：Windows 7 及以上、macOS、Linux（AppImage / deb / rpm）
• 核心卖点：一个搜索框同时覆盖五个音源，播放、下载、桌面歌词同屏搞定

🚀 完成 LX Music 安装与首次播放的 6 步

跟着走一遍，两分钟内就能听到第一首歌。

1. 挑安装包。Windows 分安装版与绿色版，安装版带自动更新、绿色版没有，打算长期用就选安装版；macOS 是 .dmg，按芯片架构选 Apple Silicon 或 Intel；Linux 提供 AppImage、deb、rpm、pacman 四种，按发行版挑。⚠️ 坑：Windows 安装版若用管理员权限安装，后续自动升级可能出现"卸载了旧版却装不上新版"，安装时选"为当前用户安装"并放在用户目录下。
2. 确认音乐源。播放链接依赖设置里的"自定义源"脚本。若所有歌都提示"请求异常"，多数是源脚本失效或网络问题，不是软件坏了。
3. 改下载路径。默认存到桌面，建议改成独立分区目录。⚠️ 坑：下载时看到ENOENT: no such file or directory, mkdir，基本就是该目录没有读写权限。
4. 顺手开启桌面歌词。打算常用就提前设置字体与排版，免得以后再翻入口。
5. 搜索。顶部搜索框输入关键词，结果带封面、歌手、音质（128k / 320k / flac），顶部下拉可切换当前音源。
6. 播放。单击试听；想连播多首，按Ctrl或Shift多选，右键添加到"我的列表"再播放。试听列表会自动收纳点过的歌，适合先快速过一遍。⚠️ 坑：设置 → 网络里的代理一旦配错，整个软件直接断网，排行榜、歌单、搜索全挂，排查网络问题先看这里。

🎯 五个高频场景，逐个说透

这五块覆盖了日常 90% 的用法，每块按"功能 → 入口 → 两步操作 → 注意点"讲。

多源搜索与换源

• 功能：一个关键词在五个音源分别检索，某个源查不到就换源再试。
• 入口：顶部搜索框 → 音源下拉。
• 操作：① 输入歌名回车出结果 ② 结果稀就切到别的音源重新搜。
• 注意点：搜索正常但播不出或歌不对，多为源脚本过期，更新源脚本或切换接口。

离线下载

• 功能：把歌存到本地，可选音质，可下载 LRC 与封面，还能把歌词内嵌进文件。
• 入口：列表右键 → 下载。
• 操作：① 选中歌曲（支持批量）② 选音质与选项后确认，默认 3 个任务并发跑。
• 注意点：先改好保存路径再批量下，别把桌面堆成仓库。

桌面歌词

• 功能：独立的歌词窗口悬浮在桌面上，支持字体选择、逐行播放样式、锁定位置与置顶。
• 入口：设置 → 桌面歌词。
• 操作：① 开启后选字体、定排版 ② 播放时右键播放栏 LRC 按钮，可快速锁定位置。
• 注意点：默认是关闭状态；全局快捷键Mod+Alt+0可一键显隐，但全局快捷键默认未开，需单独启用。

音效与播放控制

• 功能：均衡器、卷积混响（模拟厅堂、房间声场的效果）、音调偏移、0.5～2 倍播放速度，集中一处调。
• 入口：播放栏的音效按钮。
• 操作：① 打开音效面板 ② 选一个混响预设或拖动均衡器曲线。
• 注意点："稍后播放"是优先级最高的队列，按下一曲时先消耗它；直接点其他列表切歌会把它清空。

批量管理

• 功能：全选后一次性添加、下载，拖动即可调整列表顺序。
• 入口：任意列表 →Ctrl+A。
• 操作：①Ctrl+A全选后右键批量添加或下载 ② 按住Ctrl拖动"我的列表"里的列表项调整顺序。
• 注意点：试听列表只进不出，定期清理，不然越攒越长。

⚙️ 进阶区：开放 API、源脚本与同步

想让播放器"听话"：接自己的脚本、加音源、多端同步数据，都在这一节。

开放 API：设置 → 开放 API 启用后，本地起一个 HTTP 服务（默认端口23330），第三方脚本即可控制播放、读取状态。/subscribe-player-status接口用 SSE（服务器向浏览器单向实时推送数据的技术）推送歌词行、进度等字段，做桌面歌词挂件很方便。

curl http://127.0.0.1:23330/status

自定义源脚本：源脚本就是普通 JS 文件（ES6+），通过事件机制与主程序通信，声明支持的源与音质即可接入新音频源，会写请求就能上手。

数据同步：v2.2.0 起提供独立同步服务组件，自行部署后就是私有化的多端同步；内置的局域网同步（默认端口23332）则方便与移动版在同一个路由器下快速同步列表。

🎨 主题、快捷键与数据目录

主题负责好看，快捷键与数据目录是最常被问的两块设置。

主题库内置多套背景，也支持自定义导入，设置 → 主题设置中切换：

快捷键分两档："本地"在窗口聚焦时生效，"全局"是系统级、默认关闭。Mod在 Windows/Linux 是Ctrl，macOS 是Command，两档均可在设置 → 快捷键中重新映射。

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

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

🩺 出问题了先看这张表

八成故障都能对号入座，先查表再怀疑软件。

🤝 想参与开发

项目欢迎 PR，但有两道规矩，照着做合并会快很多：新功能先开 Issue 确认必要性；修 bug 的 PR 要附重现方式与修复前后说明。

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

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

核心代码在 src/ 下：主进程（窗口、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