洛雪音乐桌面版使用指南免费聚合多平台的开源 Electron 音乐播放器【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop晚上写代码时你只记得一句副歌却想不起歌名打开一个窗口同时搜遍几个音乐平台、挑音质最好的一版直接播不用在多个 App 和会员之间来回切——洛雪音乐桌面版lx-music-desktop就是为此设计的。它基于 Electron 40 与 Vue 3 开发采用 Apache-2.0 协议开源覆盖 Windows、macOS、Linux 三大平台当前最新版本为 v2.12.2。 核心能力跨平台聚合搜索与播放在搜索框输入歌名或歌手名客户端会并行查询多个音乐源把结果合并展示你可以直接从中挑一首播放无需关心它来自哪个平台。内置源涵盖酷我kw、酷狗kg、QQ 音乐tx、网易云wy、咪咕mg、虾米xm等各源的接口封装位于 src/renderer/utils/musicSdk/。几个和搜索直接相关的细节搜索支持模糊匹配与拼音拼音数据见 src/common/utils/pinyin/记不清完整歌名也能命中结果可显示来源标记list.isShowSource默认开启方便你判断版本默认播放质量为 128k可在播放设置里调高播放列表、稍后播放、试听队列分开管理支持多选批量操作。 安装与首次运行各系统的发布产物在打包脚本中均已定义见 package.json按平台挑选即可平台可选安装包说明Windows安装版 / 便携版 / 7z 绿色版另有 Win7 专用版便携版在程序目录创建portable文件夹即可数据随行macOSDMGx64 与 arm64 两种拖入应用程序文件夹Linuxdebamd64/arm64/armv7l/ rpm / pacman / AppImage按发行版任选其一数据目录约定Linux 在~/.config/lx-music-desktopmacOS 在~/Library/Application Support/lx-music-desktopWindows 在%APPDATA%/lx-music-desktop。首次启动建议先完成四件事挑选稳定的接口源、选定窗口尺寸默认 1114×718、确认播放质量、按习惯改一遍全局快捷键。想参与开发的话环境要求 Node ≥ 22git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install npm run dev 外观与播放参数调优窗口尺寸预设设置里提供 7 档全部可枚举如下预设宽度(px)高度(px)smaller828540small920600medium1020660big默认1114718larger1202776oversized1385896huge17001070尺寸定义来自 src/common/config.ts修改后窗口按所选档位记忆。主题系统默认主题为绿意green亮/暗模式分别独立记忆theme.lightId/theme.darkId支持道法自然式的自动亮暗切换每年 1–2 月还会自动换上新年主题。内置主题图片存放于 src/common/theme/images/例如中国水墨风与动漫风背景播放参数以下选项均有默认值集中在 src/common/defaultSetting.ts参数默认值说明播放质量128k网络好可上调播放速度1.0×支持变速默认保持音调preservesPitch: true均衡器10 段全 0频段覆盖 31Hz–16kHz31/62/125/250/500/1k/2k/4k/8k/16k混响卷积未启用主增益 10、发送增益 0内置多种预设立体声扩展未启用可调节声场与速度音调变换1.0改变音调而不改变速度 设备互联与外部控制数据同步v2.2.0 起支持三套方案——局域网同步、自建私有服务器、公共服务器。本机默认角色为服务器监听端口 23332sync.server.port其他设备以客户端身份接入首次配对通过验证码完成同步内容包括列表、播放数据与设置。相关实现在 src/main/modules/sync/。开放 API在设置 → 开放 API中启用后本机启动一个 HTTP 服务默认端口 23330openAPI.port默认只绑定 127.0.0.1也可勾选绑定局域网供其他设备调用。v2.12.0 起接口新增了音量、静音、播放进度控制与完整歌词获取。接入后可用于定时播放歌单、语音助手接管等自动化场景。全局快捷键默认仅窗口内快捷键生效全局快捷键需手动开启默认映射如下可在设置 → 快捷键中全部重映射源码见 src/common/defaultHotKey.ts按键动作Ctrl/⌘ F5窗口内播放/暂停Ctrl/⌘ ← / →窗口内上一首 / 下一首F1窗口内聚焦搜索框Ctrl/⌘ Alt F5全局播放/暂停Ctrl/⌘ Alt ↑ / ↓全局音量加 / 减Ctrl/⌘ Alt 0全局显示/隐藏桌面歌词另有两个实用开关启动参数-hidden可让程序直接最小化到托盘桌面歌词支持置顶、锁定、逐字高亮与翻译/罗马音显示。 排障与低配设备优化常见现象与排查方向现象排查方向搜索或播放提示请求异常换网络如手机热点、更换 DNS、检查防火墙或软件内代理设置Windows 下音频加载失败检查Internet 选项 → 局域网设置中是否启用了代理同步连接失败确认双方端口 23332 未被防火墙拦截、验证码一致下载中断或落盘失败检查磁盘空间、目录写入权限调低并发默认 3 个任务低配设备可尝试关闭透明窗口common.transparentWindow、关闭界面动画、减少同时下载数、选用纯色简单主题。 适合谁以及下一步在多个平台间频繁切换、不想重复开会员的用户是它最典型的场景需要跨设备同步列表与设置的用户从局域网同步起步最省事做自动化集成的用户先启用开放 API 再对接定时任务或语音助手想贡献代码的用户从 src/renderer/ 的界面层或 src/renderer/utils/musicSdk/ 的源接口入手。建议日常备份数据目录并留意更新日志中的接口变动。 相关文档与源码路径更新日志CHANGELOG.md常见问题FAQ.md主界面源码src/renderer/核心播放器src/renderer/core/player/音乐源接口src/renderer/utils/musicSdk/主题构建src/common/theme/发布脚本publish/【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
洛雪音乐桌面版使用指南免费聚合多平台的开源 Electron 音乐播放器【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop晚上写代码时你只记得一句副歌却想不起歌名打开一个窗口同时搜遍几个音乐平台、挑音质最好的一版直接播不用在多个 App 和会员之间来回切——洛雪音乐桌面版lx-music-desktop就是为此设计的。它基于 Electron 40 与 Vue 3 开发采用 Apache-2.0 协议开源覆盖 Windows、macOS、Linux 三大平台当前最新版本为 v2.12.2。 核心能力跨平台聚合搜索与播放在搜索框输入歌名或歌手名客户端会并行查询多个音乐源把结果合并展示你可以直接从中挑一首播放无需关心它来自哪个平台。内置源涵盖酷我kw、酷狗kg、QQ 音乐tx、网易云wy、咪咕mg、虾米xm等各源的接口封装位于 src/renderer/utils/musicSdk/。几个和搜索直接相关的细节搜索支持模糊匹配与拼音拼音数据见 src/common/utils/pinyin/记不清完整歌名也能命中结果可显示来源标记list.isShowSource默认开启方便你判断版本默认播放质量为 128k可在播放设置里调高播放列表、稍后播放、试听队列分开管理支持多选批量操作。 安装与首次运行各系统的发布产物在打包脚本中均已定义见 package.json按平台挑选即可平台可选安装包说明Windows安装版 / 便携版 / 7z 绿色版另有 Win7 专用版便携版在程序目录创建portable文件夹即可数据随行macOSDMGx64 与 arm64 两种拖入应用程序文件夹Linuxdebamd64/arm64/armv7l/ rpm / pacman / AppImage按发行版任选其一数据目录约定Linux 在~/.config/lx-music-desktopmacOS 在~/Library/Application Support/lx-music-desktopWindows 在%APPDATA%/lx-music-desktop。首次启动建议先完成四件事挑选稳定的接口源、选定窗口尺寸默认 1114×718、确认播放质量、按习惯改一遍全局快捷键。想参与开发的话环境要求 Node ≥ 22git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install npm run dev 外观与播放参数调优窗口尺寸预设设置里提供 7 档全部可枚举如下预设宽度(px)高度(px)smaller828540small920600medium1020660big默认1114718larger1202776oversized1385896huge17001070尺寸定义来自 src/common/config.ts修改后窗口按所选档位记忆。主题系统默认主题为绿意green亮/暗模式分别独立记忆theme.lightId/theme.darkId支持道法自然式的自动亮暗切换每年 1–2 月还会自动换上新年主题。内置主题图片存放于 src/common/theme/images/例如中国水墨风与动漫风背景播放参数以下选项均有默认值集中在 src/common/defaultSetting.ts参数默认值说明播放质量128k网络好可上调播放速度1.0×支持变速默认保持音调preservesPitch: true均衡器10 段全 0频段覆盖 31Hz–16kHz31/62/125/250/500/1k/2k/4k/8k/16k混响卷积未启用主增益 10、发送增益 0内置多种预设立体声扩展未启用可调节声场与速度音调变换1.0改变音调而不改变速度 设备互联与外部控制数据同步v2.2.0 起支持三套方案——局域网同步、自建私有服务器、公共服务器。本机默认角色为服务器监听端口 23332sync.server.port其他设备以客户端身份接入首次配对通过验证码完成同步内容包括列表、播放数据与设置。相关实现在 src/main/modules/sync/。开放 API在设置 → 开放 API中启用后本机启动一个 HTTP 服务默认端口 23330openAPI.port默认只绑定 127.0.0.1也可勾选绑定局域网供其他设备调用。v2.12.0 起接口新增了音量、静音、播放进度控制与完整歌词获取。接入后可用于定时播放歌单、语音助手接管等自动化场景。全局快捷键默认仅窗口内快捷键生效全局快捷键需手动开启默认映射如下可在设置 → 快捷键中全部重映射源码见 src/common/defaultHotKey.ts按键动作Ctrl/⌘ F5窗口内播放/暂停Ctrl/⌘ ← / →窗口内上一首 / 下一首F1窗口内聚焦搜索框Ctrl/⌘ Alt F5全局播放/暂停Ctrl/⌘ Alt ↑ / ↓全局音量加 / 减Ctrl/⌘ Alt 0全局显示/隐藏桌面歌词另有两个实用开关启动参数-hidden可让程序直接最小化到托盘桌面歌词支持置顶、锁定、逐字高亮与翻译/罗马音显示。 排障与低配设备优化常见现象与排查方向现象排查方向搜索或播放提示请求异常换网络如手机热点、更换 DNS、检查防火墙或软件内代理设置Windows 下音频加载失败检查Internet 选项 → 局域网设置中是否启用了代理同步连接失败确认双方端口 23332 未被防火墙拦截、验证码一致下载中断或落盘失败检查磁盘空间、目录写入权限调低并发默认 3 个任务低配设备可尝试关闭透明窗口common.transparentWindow、关闭界面动画、减少同时下载数、选用纯色简单主题。 适合谁以及下一步在多个平台间频繁切换、不想重复开会员的用户是它最典型的场景需要跨设备同步列表与设置的用户从局域网同步起步最省事做自动化集成的用户先启用开放 API 再对接定时任务或语音助手想贡献代码的用户从 src/renderer/ 的界面层或 src/renderer/utils/musicSdk/ 的源接口入手。建议日常备份数据目录并留意更新日志中的接口变动。 相关文档与源码路径更新日志CHANGELOG.md常见问题FAQ.md主界面源码src/renderer/核心播放器src/renderer/core/player/音乐源接口src/renderer/utils/musicSdk/主题构建src/common/theme/发布脚本publish/【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
