LX Music 桌面版：免费开源多音源播放器的完整上手指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
LX Music 桌面版是一款基于 Electron 与 Vue 3 的免费开源桌面音乐播放器，把酷我、酷狗、QQ 音乐、网易云、咪咕等多个主流音源聚合进同一个搜索界面，覆盖搜索、试听、下载、列表管理与多端同步，适合希望用单一工具跨平台找歌、存歌，而不必在多个客户端之间来回切换的用户。
认识 LX Music
项目采用 Apache License 2.0 协议发行，仓库中另附一份补充协议，明确其定位是技术研究与学习交流、不作商业用途，并要求使用者在 24 小时内清除使用过程中产生的版权数据。它支持 Windows 7 及以上、macOS 与 Linux；Windows 下提供安装版与绿色版两种形态，若程序目录里存在portable文件夹，软件会自动改用它存放全部数据，便于整包迁移。
主界面分为三块：左侧导航栏承载搜索、排行榜、歌单、我的列表、下载与设置，中间是内容列表，底部为播放栏。播放详情页可展示歌词，桌面歌词窗口能随播放独立悬浮。
下载、安装与首次配置
- 到项目发布页下载对应系统的安装包：Windows 选
.exe安装版或绿色版，macOS 为.dmg，Linux 提供.AppImage、.deb、.rpm。macOS 首次启动若提示"已损坏"，在终端对应用执行sudo xattr -rd com.apple.quarantine命令去除隔离标记即可。 - 首次启动后逐项检查设置："音乐来源"里选定内置音源与自定义源——在线音频链接实际由这些源返回，源的可用性直接决定播放成功率；再设置下载目录与偏好音质（128k、320k、flac、24bit 四档）。
- 在搜索框输入歌名或歌手，候选项可用方向键上下选择、回车确认；点击结果行开始播放，右键即可把歌曲加入"我的列表"留存。
官方说明默认设置并不以新手友好为目标，建议先通读一遍设置项与播放列表机制的文档，能少走弯路。
三个典型使用场景
日常听歌与歌词
搜索、歌单、排行榜共用同一套列表界面，单曲点击播放时会自动进入试听列表；想连续播放一批歌，用Ctrl或Shift多选后加入"我的列表"中的自建列表即可，"稍后播放"队列优先级最高，点下一曲时先行消耗。开启桌面歌词后，歌词窗口跟随播放实时滚动，可锁定位置、可设置置顶。
批量下载与列表管理
多选后右键触发下载，任务在后台排队执行，不占用当前播放。下载页可追踪进度、移除任务，并把成品歌曲直接编入列表。列表内支持Ctrl+F列表内搜索，按住Ctrl可进入拖动模式调整列表顺序，右击收藏的在线歌单还能"更新"为线上最新版本。
多端列表同步
v2.2.0 起项目提供了独立的数据同步服务，部署到自有服务器后即为私人多端同步方案，列表与偏好数据完全由自己保管；只在同一局域网内使用的话，在"设置 - 数据同步"开启本地同步，PC 与移动端连上同一网络后列表实时互通，首次合并时需选择两边的合并策略。注意局域网同步为明文传输，请在受信任的网络下使用。
主题切换与快捷键一览
设置中提供多个内置主题，支持实时预览，也可自定义配色。以下背景均为仓库自带示例：
快捷键分本地（窗口聚焦时）与全局（窗口失焦时）两个作用域，均可在"设置 - 快捷键"中修改，常用默认值如下：
Mod+F5播放/暂停，Mod+←/Mod+→上一曲/下一曲，F1聚焦搜索框，F11全屏（macOS 上Mod对应Command）- 全局作用域：
Mod+Alt+↑/↓音量增减，Mod+Alt+0显示/隐藏桌面歌词，Mod+Alt+-锁定歌词，Mod+Alt+=歌词置顶 - 列表内
Ctrl+A全选，配合Shift/Ctrl完成连续或不连续多选
开放 API 与进阶玩法
v2.7.0 起，"设置 - 开放 API" 会在本机启动一个 HTTP 服务，供脚本或其他软件控制播放。启用后，例如：
curl http://127.0.0.1:9527/status curl http://127.0.0.1:9527/skip-next除/play、/pause、/status、/lyric外，还提供/seek?offset=拖动进度、/volume?volume=调音量与/subscribe-player-status状态订阅，便于接入命令行、自动化脚本或智能家居流程；习惯从浏览器调起的用户也可使用 v1.17.0 起支持的lxmusic://Scheme URL。
常见问题速查
- 所有歌曲都无法播放：先换热点排查网络，再到"音乐来源"切换接口，并确认已是最新版本；仍失败多半是 DNS 问题，可改为公共 DNS 后重启软件。
- 下载报
ENOENT目录错误：通常是下载目录缺少读写权限，更换一个可写目录即可。 - Windows 10/11 界面不显示：用
--disable-gpu-sandbox参数启动；Windows 7 请先开启 Aero 主题，或加-dt以非透明模式运行。 - 杀毒软件报警：安装包由 CI 从开源代码构建，可自行查阅代码判断；个别安全软件因音频设备接口误报访问摄像头，直接拒绝即可。
参与项目或体验源码
仓库欢迎 PR：克隆代码后在dev分支开发，新功能建议先提 Issue 确认必要性。开发环境要求 Node ≥ 22、npm ≥ 8.5.2：
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop熟悉 TypeScript 与 Vue 的话，可从 音乐源实现 与 界面渲染代码 入手；仓库同时保留了自定义源脚本入口，写 JavaScript 就能扩展新的音源接入。最后提醒一句：软件依赖第三方源返回的在线链接，仅面向技术研究，音乐内容请通过官方渠道支持正版。开发团队另有一个新项目 Any Listen 在推进 WebDAV 与本地文件列表能力，有本地播放需求的用户可以持续关注。想直接使用的读者，到项目发布页取最新安装包，按本文步骤完成第一次播放即可。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
