一个搜索框聚合 7 大音乐平台:洛雪音乐助手跨平台播放器上手指南
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
想听的歌散落在四五个 App 里,每个都要登录,付费墙还各不相同。洛雪音乐助手(lx-music-desktop)是条更省事的路:开源的跨平台桌面播放器,把多平台音乐聚合装进同一个搜索框,一次按键,一份结果,数据全部留在本机。
先跑起来:第一次使用体验
安装按系统取包即可:Windows 给 exe 安装包和 7z 绿色版,另有 Win7 兼容版;Linux 给 deb、rpm、AppImage、pacman;macOS 是 Intel 和 Apple Silicon 两套 dmg。装完打开,界面分四块:顶部搜索框,左侧一条窄导航(搜索、榜单、歌单、喜欢、下载、设置),中间是歌曲卡片流,底部播放条。
第一次播放动线很短:输入关键词 → 默认「全部来源」聚合搜索 → 结果页顶部可再筛来源 → 点任意卡片开始播放。切歌、音量、全屏都在播放条上,不藏菜单。默认播放音质是 128k,嫌闷就去设置里调,后面会讲。
多平台聚合:一个搜索框背后的工作原理
现象先说:敲一次搜索,界面上同时出现酷我、酷狗、QQ 音乐、网易云、咪咕、虾米几家平台的卡片,混排在同一页,重名歌曲会被合并,贴题的排前面。
原理不复杂。搜索动作里把所有启用平台的请求并行发出去,任何一家超时或报错都兜底成空结果,不会拖垮整页;结果回来先去重,再按关键词与歌名歌手的相似度重排。代码组织也顺着这个思路:src/renderer/utils/musicSdk/下一个平台一个目录(kw、kg、tx、wy、mg、xm 等),统一由 index.js 注册和调度。
对你可感知的效果就两条:结果出得快、重复少;想只看某一家,来源筛一下就行。
进阶玩法:数据同步、本地 API 与深度定制
同步。歌单在好几台设备上用时,设置里打开同步。项目自带同步服务模块,可以在自己的服务器或局域网电脑上部署,客户端填入地址连上,歌单和设置就会跟着走。不想折腾公网的话,家里那台常开电脑当服务器最省事。
本地开放 API。开关打开后,程序在本机起一个 HTTP 服务(默认 127.0.0.1:23330),/play、/pause、/skip-next、/lyric、/status 这些路径直接返回 JSON,还有 SSE 订阅,歌词行和播放进度实时推过来。接 Home Assistant、写自动播放脚本都用它。默认只绑本机,想从别的设备控制,在设置里勾上绑定局域网即可。
主题与桌面歌词。内置多套配色和背景,也允许自己改配色、换背景图,仓库里就放着山水、月夜这类主题素材。桌面歌词是独立窗口,尺寸、字体、颜色、置顶单独设,改完即时生效。
参与开发。环境要 Node.js 22 以上、npm 8.5.2 以上:
git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install && npm run dev给新平台加接口,就在 src/renderer/utils/musicSdk/ 下照现有平台建目录,写好搜索、歌词等函数,再到 index.js 注册即可。
日常细节与避坑
- 搜索写「歌手 歌名」比只写歌名准得多,多关键词用空格分开。
- 音质从 128k、320k 到 FLAC 都能选;下载时勾上嵌入封面和歌词,文件本身就带元数据。
- 数据全在本机 SQLite 库里:Linux 在
~/.config/lx-music-desktop,macOS 在~/Library/Application Support/lx-music-desktop,Windows 在%APPDATA%/lx-music-desktop。换机器或重装前,把这个目录拷走就是完整备份。 - 绿色便携版适合不想装软件的人,整个文件夹拷进 U 盘就能跑。
- 桌面歌词和系统托盘图标默认都是关的,用得上要手动打开。
谁适合用,谁不必用
适合两类人:一是歌单横跨多个平台、每天要在不同应用间来回切的人;二是愿意自建同步服务、给本地 API 写点脚本的技术向用户。如果你只听一两个平台并且愿意付费,聚合带来的便利很小,不必装它。
一句话定位:它把多个免费音乐源装进同一个搜索框,数据、歌单、备份全在自己手里;热门曲目的可用性,最终取决于上游接口。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考