洛雪音乐桌面版：免费跨平台音乐聚合播放快速上手

洛雪音乐桌面版：免费跨平台音乐聚合播放快速上手

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

洛雪音乐桌面版（lx-music-desktop）是基于 Electron 30 与 Vue 3 开发的开源音乐软件，把酷我、酷狗、QQ 音乐、网易云、咪咕五个平台的搜索结果与在线播放聚合到同一个窗口里。当前版本 v2.12.2，完全免费，覆盖 Windows 7 及以上、macOS、Linux 三大平台。下面按"装好 → 听上 → 调界面声音 → 多设备同步 → 自动化"的顺序，把每个环节该点哪里、改成什么讲清楚。

📦 从装到听第一首歌：五分钟跑通完整体验

这一节的目标只有一个：你下载完安装包之后，五分钟之内听到第一首完整播放的歌。

按系统选安装方式

首次启动只做 3 件事

默认配置面向的是熟练用户，第一次打开建议先改这三处，其余保持默认即可：

1. 音乐来源接口：打开"设置 → 音乐来源"。默认的temp接口在你的网络环境下不一定通，列表里换个接口再试，后面搜索全靠它。
2. 播放质量：player.playQuality默认是128k。网络稳定时改到320k或flac，软件还支持flac24bit档。
3. 窗口尺寸："设置 → 窗口尺寸"共 7 档预设，默认落在 1114×718。小屏笔记本改小一档，2K/4K 宽屏改大两档，不用自己拖边框。

用聚合搜索播放第一首歌

1. 在顶部搜索框输入歌名（或歌手名），回车。
2. 结果会合并kw/kg/tx/wy/mg五个来源的候选，同一首歌来自不同平台的版本都列出来。
3. 挑一条可用音质最高的记录点播放，歌曲会自动进入试听队列开始出声。默认128k足够听清，音质党再换更高档。

🎚️ 让界面和声音都按你的来

软件一共内置 15 套主题，声音侧带十段均衡器和独立桌面歌词窗口，外观与听感都可以逐项调。

外观：主题与窗口尺寸

主题在"设置 → 主题"里切换，挑几套有代表性的：

• 绿意盎然：默认主题，浅绿底白面板，信息层级干净；
• 黑灯瞎火：纯暗色系，深夜关灯后看屏幕不刺眼；
• 新年快乐：每年 1～2 月会自动设为默认主题，带节日配色。

主题支持自定义，背景图可换成任意本地图片，动漫风这类风格不用等官方上新：

窗口尺寸 7 档预设里，日常用记住这三档就够：

声音：均衡器、混响与桌面歌词

• 十段均衡器：从 31Hz 到 16kHz 共 10 个频点独立加减，人声、低频可以分别压或抬。
• 卷积混响：加载预设效果文件（仓库自带 15 个 .wav 预设），给干声加上一间"厅堂"。
• 立体声扩展：调宽声场，听人声分离度高的曲目时效果最明显。
• 音调变换：变速同时可保持原音调（preservesPitch默认开启），快进试听不跑调。
• 桌面歌词：默认 450×300 的独立窗口，可置顶、可锁定，字体、行距、透明度、未唱/已唱颜色都能改，并支持显示翻译与罗马音。

📡 多台设备听同一份歌单

自 v2.2.0 起软件内置数据同步，PC 端默认同步端口为23332。两条路线的取舍直接看表：

同步的核心内容是你的"我的列表"等列表数据：首次同步时若两端都有列表会弹窗让你选合并策略，之后每次连接会自动做双向合并，增删歌曲不用手动搬运。注意同步走明文传输，尽量在受信任的网络里开启。

🤖 让它听指挥：本地 API 与自动化

从 v2.7.0 起，在"设置"里启用开放 API 后，软件会在本地起一个 HTTP 服务，默认端口 23330，把播放状态和控制指令开放给第三方调用：

# 查询播放状态（含歌曲、进度、歌词） curl http://127.0.0.1:23330/api/status # 播放 / 暂停 / 设音量（0-100） curl -X POST http://127.0.0.1:23330/api/play curl -X POST http://127.0.0.1:23330/api/pause curl -X POST "http://127.0.0.1:23330/api/volume?volume=60"

常见玩法，每个都只有一行改动：

• 智能家居：让 Home Assistant 之类的系统调用/api/play、/api/pause，把音箱控制并入家居面板。
• 定时播放：系统定时任务里用启动参数-play直接指定列表播放，到点自动开始。
• 浏览器唤起：v1.17.0 起支持lxmusic://的 Scheme URL，网页上就能触发搜索和播放。
• 开机直达：-search="歌名"启动即搜索，配合快捷方式做"今日歌单"入口。

🧯 卡住了怎么办

官方 FAQ 覆盖了绝大多数问题，高频的五类整理如下（均为 FAQ.md 中的既有方案）：

低配机器跑不动时，按顺序试三条，每条都是加一个启动参数或改一个数字的事：

• 快捷方式加参数-dha禁用硬件加速，解决窗口异常与卡顿。
• 加参数-dt用非透明窗口启动，减少渲染开销。
• 把并发下载数从默认的 3 调低，并关闭界面动画，把资源让给播放。

✅ 谁适合下载、下一步做什么

• 多平台切换者：一个窗口搜遍五个来源，不用再按平台找歌。
• 本地音乐管理者：可导入本地文件，下载时能把封面与歌词嵌入音频文件。
• 多设备用户：手机与电脑歌单靠同步保持同一份。
• 自动化爱好者：23330 端口的 API 加lxmusic://唤起，脚本随便接。

动手之前记住两件事：所有配置与列表都存在数据目录（Windows 为%APPDATA%\lx-music-desktop，macOS 为~/Library/Application Support/lx-music-desktop，Linux 为~/.config/lx-music-desktop），首次开启同步前先把这个目录备份一份；另外项目协议有明确要求——

使用过程中产生的版权数据，请务必在 24 小时内清除，音乐平台不易，请尊重版权、支持正版。

装好之后，先去搜索框里放一首你最近总点不到资源的老歌试试。

相关资源

• 项目说明与协议：README.md
• 版本更新记录：CHANGELOG.md
• 常见问题全文：FAQ.md
• 播放器核心源码：src/renderer/core/player/
• 同步服务源码：src/main/modules/sync/

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