洛雪音乐桌面版安装教程：多平台音乐聚合、多设备同步与开放 API 快速上手

洛雪音乐桌面版安装教程多平台音乐聚合、多设备同步与开放 API 快速上手【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop换三台设备用歌单就得重新收藏三遍想找一首老歌得在好几个 App 之间来回切。洛雪音乐桌面版lx-music-desktop把这类重复劳动合并掉了它是一个基于 Electron 30 和 Vue 3 的跨平台播放器在同一个界面搜索并播放酷我、酷狗、QQ 音乐、网易云音乐、咪咕音乐等多个平台的歌曲配合数据同步功能歌单和设置可以在你的几台设备之间保持一致。这篇教程按「装好 → 用熟 → 调顺 → 进阶」的顺序讲完整个过程全部参数都来自当前代码和更新日志。 几分钟装好跑起来安装本身没有门槛真正花时间的其实是首次启动后的那几项基础配置建议一次做完后面就不用再动。最短路径有序到项目 Releases 页面按你的系统和架构选对安装包见下表。首次启动后在「设置 → 网络设置」里选一个稳定的音乐源接口接口不通时换下一个即可。在「设置 → 播放设置」里确定播放质量如 128k / 320k / 无损和播放模式。挑一个窗口尺寸预设并把全局快捷键过一遍见后文快捷键表。平台安装包格式说明Windows 7 及以上安装版Setup、便携版Portable便携版数据存于程序文件夹适合拷到 U 盘macOSDMGIntel 与 Apple Siliconarm64分别有包LinuxDEB / RPM / AppImageAppImage 赋予执行权限后可直接运行装好后的主界面左侧导航中间歌曲列表底部播放栏。 高频使用场景功能清单不如真实用法直观挑三个最常被用到的场景说清楚「做什么、用哪个功能、得到什么结果」。场景一通勤路上跟唱用顶部搜索框找到想听的歌按Alt D唤出桌面歌词歌词会悬浮在所有窗口之上颜色、字体都可在「设置 → 桌面歌词」里调。适合地铁上戴着耳机跟唱也适合做饭时把歌词钉在屏幕上。场景二办公时专注听歌把某个歌单设为列表循环然后用全局快捷键接管一切空格播放/暂停、Ctrl →切下一首、Ctrl ↑/↓调音量。全程不用点开播放器窗口工作流不被打断。播放速度支持 0.5x–2.0x音调变换还能在不改变速度的前提下升降调用来磨耳朵听英文播客刚好。场景三家里、公司、路上三台设备轮换打开数据同步v2.2.0 起支持把「我的列表」、播放记录和各处设置同步过去。在客厅电脑上收藏的歌到公司打开软件就是同一份列表不用再建第二遍。具体同步方案怎么选放到进阶玩法里细说。 把界面调成自己的样子外观和手感类设置都集中在「设置」页改完即时生效个别项重启生效设置里有标注。主题内置多套主题例如默认清新的「绿意盎然」、跟随系统亮暗自动切换的「道法自然」、传统艺术风格的「中国水墨风」以及动漫风格、新年节日主题等1 月至 2 月启动时还会默认套上新年皮肤。喜欢水墨风的话效果大致是这样的动漫风格主题同样可以在设置里一键切换窗口尺寸提供 7 档预设覆盖从侧边栏小窗到全屏体验级别宽 × 高px适合场景较小828 × 540当作侧边栏或小屏幕使用小920 × 600日常轻度使用中等1020 × 660标准界面大1114 × 718日常推荐尺寸较大1202 × 776多列信息展示超大1385 × 896宽屏显示器巨大1700 × 1070全功能界面播放与音效项目可选项播放模式列表循环 / 单曲循环 / 随机播放速度0.5x – 2.0x音调变换独立升降调不改变速度均衡器内置 10 段音效均衡器预设、声场效果等可在播放详情里调节⚙️ 进阶玩法基础功能跑顺之后真正拉开效率差距的是下面两件事跨设备同步以及让外部软件来指挥播放器。多设备数据同步v2.2.0 起方案原理适合谁局域网同步同一网络内设备互相同步无需公网 IP家里 办公室几台机器私有服务器同步部署官方数据同步服务到自己的服务器客户端连接过去默认端口 23332有服务器、在意数据安全公共服务器同步用社区维护的公共同步服务器不想自己运维设备私有服务器方案下客户端填好服务器地址、端口默认 23332和认证密钥即可连接不上时优先排查防火墙是否放行该端口。本地开放 APIv2.7.0 起在「设置 → 开放 API」中开启后软件会在本地启动一个 HTTP 服务默认端口 23330默认只绑定本机。v2.12.0 起这套接口新增了对声音大小、静音、播放进度和完整歌词的控制。几条常用命令# 查看当前播放状态 curl http://127.0.0.1:23330/api/player/status # 暂停播放 curl -X POST http://127.0.0.1:23330/api/player/pause # 音量调到 80 curl -X POST http://127.0.0.1:23330/api/player/volume \ -H Content-Type: application/json \ -d {volume: 80}落地场景举例智能家居联动在 Home Assistant 或 Node-RED 里写一条规则进门自动触发播放、出门自动暂停播放器不需要开着窗口待命。定时唤醒/下班切换用 crontab 在早晨 7 点调用播放接口切到「通勤歌单」晚上 7 点切到「专注歌单」。语音/脚本控制任何能发 HTTP 请求的脚本都可以把它当作播放后端来用。 排坑手册常见问题现象 → 处理办法现象处理办法歌曲全部提示「请求异常」先换网络手机热点最快再试把 DNS 改为223.6.6.6或8.8.8.8检查防火墙是否拦了软件联网Windows 上音频加载错误多半是系统代理在捣乱运行inetcpl.cpl打开 Internet 选项 →「连接」→「局域网设置」取消勾选所有代理项歌曲无法下载依次检查磁盘剩余空间、下载目录写权限、换一个下载接口最后确认网络状态同步服务连接失败核对服务器地址与端口确认防火墙放行 23332 端口重新核对认证密钥重启同步服务再试快捷键速查可在「设置 → 快捷键」中自定义快捷键功能空格播放 / 暂停Ctrl →/Ctrl ←下一首 / 上一首Ctrl ↑/Ctrl ↓音量 / 音量 −F11全屏切换Alt D显示 / 隐藏桌面歌词Ctrl A全选当前列表Ctrl F在「我的列表」中搜索Ctrl Shift 点击多选歌曲Ctrl W关闭当前窗口Ctrl Shift W关闭所有窗口低配设备优化限制并发下载数默认 3可在「设置 → 下载设置」里调小关闭不必要的动画与透明效果选择配色简单的轻量主题减少渲染负担定期清理缓存数据。 数据存放与备份歌单、设置、下载任务都在一个数据目录里知道位置备份就只是复制文件的事。系统数据目录Windows%APPDATA%/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopLinux~/.config/lx-music-desktopWindows 下有个便携规则若程序文件夹内存在portable目录v1.17.0 起软件会自动改用该目录存数据配合便携版可以把整套数据一起拷走。手动备份 直接复制整个目录。嫌麻烦的话Linux / macOS 上挂一条定时任务更省心#!/bin/bash # 每周备份一次洛雪音乐桌面版数据示例 cd $HOME/.config tar -czf $HOME/lx-music-backup-$(date %Y%m%d).tar.gz lx-music-desktop 项目动态与参与当前版本 v2.12.2 的主要变化开放 API 补齐了音量、静音、播放进度控制与完整歌词获取主窗口新增「使用软件内置的圆角及阴影」选项默认开启新增启动参数-hidden启动时直接最小化到系统托盘新增「调换歌词翻译与歌词罗马音位置」选项支持 Any Listen 歌词的逐字播放修复了桌面歌词透明度设置不稳、个别情况下播放无声、TX 源搜索结果显示异常等问题并优化了歌单内搜索结果排序Electron 更新至 40.8.3。想贡献代码Fork 仓库后克隆到本地切换到dev分支开发完成后再向dev分支提 PR。两个惯例新功能建议先建 Issue 讨论确有必要修 bug 的 PR 请附上修复前后说明和重现方式。本地跑起来的方法可参考仓库内 src/main/ 与 src/renderer/ 目录结构构建脚本见 package.json。写在最后一个免费开源的播放器把「多平台搜歌、多设备同步、开放 API」这三件事都做了并且持续在修问题、加功能——它解决的不是某一个痛点而是把听歌这件事的重复劳动整个拿掉了。版权与使用声明摘自项目 README本项目完全免费且开源仅用于技术可行性探索与研究不接受任何商业合作与捐赠。在线数据来自各官方平台公开接口软件本身不存储任何音频数据使用过程可能产生版权数据使用者务必在 24 小时内清除。请尊重版权支持正版音乐。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考