洛雪音乐桌面版：跨平台免费开源音乐聚合播放器，五源合一还能接脚本
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
洛雪音乐桌面版（lx-music-desktop）是一款基于 Electron 与 Vue 3 的跨平台免费开源音乐软件，Windows、macOS、Linux 通吃。它把酷我、酷狗、QQ 音乐、网易云音乐、咪咕音乐五个平台的在线歌曲聚进同一个搜索框，并提供多端数据同步、本地开放 API、桌面歌词与音频效果器。以下信息均出自仓库的 README、FAQ、CHANGELOG 与源码默认配置，帮你少走弯路。
一、定位与能力全景
先说结论：它解决的是「不想在五个平台间来回切」的问题，附带把播放、下载、同步、自动化一并覆盖。能力清单如下：
- 五源聚合搜索：搜索框一次查询五个来源，结果按来源标注，支持拼音检索
- 歌单/排行榜：支持各平台在线歌单、排行榜与热门榜单浏览
- 下载：可选并发、歌词与封面嵌入，按列表分组存放
- 数据同步（v2.2.0 起，实验性，明文传输）：局域网内 PC 与手机实时同步列表
- 开放 API（v2.7.0 起）：本地 HTTP 服务提供播放控制与状态订阅
- Scheme URL（v1.17.0 起）：
lxmusic://协议可从浏览器唤起软件 - 桌面歌词：独立置顶窗口，支持横/竖排与自定义
- 音频效果器：均衡器、卷积混响、声像旋转、变声
- 主题系统：内置多套主题，支持亮/暗自动切换与自定义编辑
- 全局快捷键：窗口失焦时也能控曲、调音量
二、最短上手路径：装对包，改四处，放出第一首歌
官方 README 明说默认设置不以新手友好为目标，所以首启后建议立刻把下面四处过一遍。按顺序做，五分钟内能稳定放出第一首歌。
1. 安装包怎么选才不踩坑
默认值是什么：发布页按系统提供不同包，选错类型后面会很被动。建议改成什么：Windows 长期使用选安装版（Setup）——只有它支持自动更新；macOS 选.dmg；Linux 选.deb/.rpm/.pacman/.AppImage。不领会遇到什么：Windows 绿色版（green）自动更新不可用，macOS 与 Linux 版本同样不支持自动更新，只能手动覆盖安装；另外自 2.10.0 起，Linux 至少需要GLIBC_2.29。
数据存放位置：Windows%APPDATA%/lx-music-desktop、macOS~/Library/Application Support/lx-music-desktop、Linux~/.config/lx-music-desktop。Windows 下若程序目录里存在名为portable的文件夹（v1.17.0 起），会自动改用它存全部数据，整份搬走即可，适合 U 盘携带。
2. 播放全挂时先查音乐来源接口
默认值是什么：默认走temp接口（common.apiSource），在线音频链接全靠它返回。建议改成什么：先不动；一旦批量失败，到「设置 → 音乐来源」切换其他接口。不领会遇到什么：接口失效或网络不通时，所有歌曲都会播放失败，症状统一是「请求异常」。
3. 窗口尺寸按屏幕定档
默认值是什么：第 4 档 big，1114×718，共 7 档预设。建议改成什么：按屏幕习惯调。不领会遇到什么：小屏上默认窗口偏大，操作区被挤压。
| 档位 | 尺寸（宽×高，px） |
|---|---|
| smaller / small / medium | 828×540 / 920×600 / 1020×660 |
| big（默认） | 1114×718 |
| larger / oversized / huge | 1202×776 / 1385×896 / 1700×1070 |
4. 播放音质与列表播放机制
默认值是什么：音质 128k（player.playQuality）；播放模式为列表循环。建议改成什么：音质可上调到 320k、flac、flac24bit，实际能用哪档取决于所选来源接口能否返回对应格式。不领会遇到什么：这是全软件最反直觉的一点——在搜索、歌单、排行榜里单击某首歌，会先把它加入「我的列表」的试听列表再播放；想一次播多首，必须多选（Shift连选、Ctrl多选、Ctrl+A全选）后批量加入自己的列表，或丢进「稍后播放」。「稍后播放」是优先级最高的特殊队列，点「下一曲」时先消耗它，但只要你通过点击其他列表的方式切歌，该队列会被直接清空。
快捷键方面：应用内默认启用Ctrl+F5播放/暂停、Ctrl+←/Ctrl+→切歌、F1聚焦搜索框、F11全屏（v1.19.0 起）；全局快捷键默认关闭，需要到「设置 → 快捷键」自行开启，开启后窗口失焦也能控曲。
三、高频场景
场景 1：找歌并下载到本地
搜索框输入歌名或歌手名即可同时查五个来源，支持拼音检索；也可以直接粘贴歌单链接或歌单 ID 打开外部歌单。注意歌单源必须与链接所属平台一致，不一致时右上角切换歌单源；网易源的「我喜欢」歌单需要登录态，做法是在链接或 ID 后拼接###token。
下载功能默认关闭，到「设置 → 下载」启用。默认保存在桌面，最多3 个任务并发，文件名默认「歌名 - 歌手」；可勾选是否下载 LRC/逐字歌词、是否把封面与歌词嵌入文件，以及按列表名建子目录分组存放。
场景 2：把列表管顺
在线列表里的歌不能直接整列播放，必须先进入「我的列表」：歌单详情页顶部的播放按钮只是临时播放，想长期播放就先点收藏。多选规则：先按Shift或Ctrl再点选，Ctrl+A全选，选完右键可批量加入列表、下载或稍后播放。已收藏的在线歌单支持右键「更新」，用最新在线内容覆盖本地列表——留意它会替换掉本地歌曲。我的列表内按住Ctrl可进入拖动模式调整列表顺序，Ctrl+F打开列表内搜索框。
场景 3：PC 与手机同步
这是实验性功能，首次使用建议先备份一次列表；传输为明文，只在受信任的网络下用。PC 端在「设置 → 数据同步」开启后，本机23332端口会起同步服务；手机端填入该地址与端口，点「启动同步」。两端必须在同一局域网。首次同步若两边列表都不为空，PC 端会弹同步方式选择框；之后自动按两边内容合并。连不上时，在手机浏览器打开http://<PC地址>:23332/hello，能打开并显示Hello~::^-^::说明网络互通，否则检查防火墙是否放行 23332 端口、路由器是否开了 AP 隔离。
场景 4：接脚本与自动化
三个入口，按需取用（接口细节见下一板块的「连接」层，此处只讲用法）：
- 开放 API（v2.7.0 起）：本地 HTTP 服务，适合写脚本轮询或触发控制
- Scheme URL（v1.17.0 起）：
lxmusic://协议，适合从浏览器页面唤起软件 - 启动参数：
-search="突然的自我 - 伍佰"启动即搜索；-play="type=songList&source=myList&name=默认列表"直接播指定列表；-hidden最小化到托盘启动（v2.12.0 起）；-proxy-server="127.0.0.1:1081"指定代理（v1.17.0 起）
四、进阶定制：外观、声音、连接三层收纳
外观：主题、背景与桌面歌词
主题内置「绿意盎然」（默认）、「蓝田生玉」、「蛋雅深蓝」、「橙黄橘绿」等多套，另有亮/暗模式自动切换主题，支持自定义编辑与搭配背景图；每年 1～2 月默认自动换成新年皮肤。桌面歌词是独立置顶窗口，默认 450×300，支持横/竖排、锁定、透明度调节，可显示翻译与罗马音，暂停或主窗口全屏时可自动隐藏；配合全局快捷键Ctrl+Alt+0在任意界面快速显隐。
声音：效果器、音质与倍速
播放页内置 10 段均衡器（31Hz～16kHz）、卷积混响（附带多组房间/厅堂音色预设）、立体声声像旋转、变声（改变音调不改变速度），默认全部关闭，按需开启。倍速默认 1 倍，「变调不变速」默认开启；歌曲临近结束时会自动预取下一首链接，减少自动切歌的等待。
连接：开放 API、Scheme 与启动参数
- 开放 API：在设置中启用后，本地23330端口起 HTTP 服务，默认只监听
127.0.0.1（可选绑定局域网）。提供/play、/pause、/skip-next、/skip-prev、/seek、/volume、/mute、/status、/lyric、/collect等接口，还支持 SSE 形式的播放状态订阅，方便接智能家居或脚本：
curl -X POST "http://127.0.0.1:23330/pause" curl "http://127.0.0.1:23330/status"- Scheme URL：以
lxmusic://开头，支持music/search（搜索）、songlist/open（打开歌单）、music/play（播放指定歌曲）；传参有 URL 编码的 JSON 与简写 URL 两种方式，官方配套油猴脚本用于网页调用。 - 数据同步服务：局域网同步之外的另一条路——官方另发布独立同步服务，可部署到自己服务器作为私有同步后端，绕开同一局域网的限制。
五、问题速查与资源
故障速查表
| 症状 | 排查动作 |
|---|---|
| 所有歌曲提示「请求异常」 | 换网络/手机热点 → 「设置 → 音乐来源」切换其他接口 → 升级到最新版 |
提示getaddrinfo EAI_AGAIN或无法连接服务器 | 多为 DNS 问题：改为自动获取，或手动改成223.6.6.6/8.8.8.8，改完重启软件 |
| Windows 提示「音频加载错误」 | 多为系统代理干扰：Win+R运行inetcpl.cpl，在「连接 → 局域网设置」中取消代理勾选 |
| 同步服务连不上 | 两端须在同一个路由器下；检查防火墙是否放行 23332；路由器开 AP 隔离则不可用；手机浏览器访问http://<PC地址>:23332/hello验证连通性 |
| 界面显示不完整 / 黑屏 | 依次尝试启动参数--disable-gpu-sandbox、-dha（禁用硬件加速，v1.6.0 起）、-dt（禁用透明窗口）；低配设备关闭透明窗口可减轻渲染负担 |
下载报ENOENT ... mkdir | 下载目录没有读写权限，换一个目录 |
| macOS 提示「已损坏」 | 软件未签名，终端执行解除隔离命令 |
sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.app下一步建议
- 新手：先把「音乐来源、窗口尺寸、播放音质、列表机制」四处过一遍，按自己习惯配快捷键，然后跑通一次「搜索 → 加入列表 → 播放 → 下载」的完整流程。
- 进阶：开启局域网同步，或启用开放 API 接一个自动化任务；有本地文件播放需求的用户可关注团队在更新日志中提到的新项目 Any Listen（支持本地文件列表与 WebDAV 歌曲播放）。
源码参考：核心播放器在 src/renderer/core/player/，各平台音乐源实现见 src/renderer/utils/musicSdk/，数据同步模块在 src/main/modules/sync/。
最后一条硬约束：项目协议要求你在24 小时内清除使用过程中产生的版权数据；软件本身不存储音频，只面向技术交流。建议定期备份数据目录，防止列表与设置丢失。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
