LX Music 使用指南:五音源免费聚合试听与歌曲完整本地存档
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
LX Music(当前版本 2.12.2)是一个基于 Electron + Vue 3 开发、采用 Apache 2.0 协议开源的桌面音乐工具。核心用法很简单:在搜索框里敲一次歌名,酷我、酷狗、QQ音乐、网易云、咪咕五个平台的结果一起返回,音质最高到 flac24bit,不用注册账号、不用开会员,听完还能把音频文件完整存进自己的硬盘。
装对版本与数据目录:首次运行的准备和空白屏修复
先按你的系统选包,别下错:
| 平台 | 包格式 | 备注 |
|---|---|---|
| Windows | Setup 安装版 / 绿色版 | 安装版带自动更新;绿色版免安装、拷 U 盘即用 |
| macOS | .dmg | 无自动更新,手动下载新包覆盖 |
| Linux | .deb / .rpm / .AppImage / .pacman | 按发行版对应的包管理器选 |
配置文件、歌曲列表这些数据默认存在固定位置,备份或迁移机器时用得上:
| 系统 | 默认数据目录 |
|---|---|
| Windows | %APPDATA%/lx-music-desktop |
| Linux | ~/.config/lx-music-desktop |
| macOS | ~/Library/Application Support/lx-music-desktop |
Windows 上还有个省事的小机制:从 v1.17.0 起,如果程序目录里手动建了portable文件夹,所有数据会自动改存到这里,整个程序文件夹搬走即可带走配置。
首次启动勾选完协议就能搜歌。如果 Windows 10/11 上打开后整屏空白,多半是 GPU 沙箱和显卡驱动打架,不用重装:给启动快捷方式加上--disable-gpu-sandbox参数;没效果再依次换成--no-sandbox、-dha、--disable-gpu逐个试,通常前两个就能救回来。
一次搜索覆盖五平台:试听、入列表与故障排查
把歌名敲进搜索框,五个音源的结果合并展示,每条结果都标了可用音质(128k、320k、flac、flac24bit)。播放音质默认是 128k,走流量时保持默认最省;网络稳定再进设置里换更高规格。
播放机制对新手很友好:点播放后歌曲会自动进入"我的列表",以后想再听随时找得到;某首播放出错时软件会自动跳过、接着播下一首,不用你盯着管。
整页搜索或排行榜加载不出来时,按这个顺序排障,命中率最高:
- 先去 设置 → 音乐来源 换一组接口源
- 无效就切手机热点快速验证,能确定是网络问题还是接口问题
- 还不行把 DNS 手动改成
223.6.6.6或8.8.8.8,然后重启软件
进阶玩法:内置的五个音源之外,还能自己挂音源。在用户数据目录里放一个 JavaScript 脚本,让它监听musicUrl事件并返回歌曲直链,就等于新增了一个源;脚本里可以用自带的request发不受跨域限制的 HTTP 请求,还内置了 AES、MD5、RSA 这类加解密工具,接口签名不是问题。
批量存歌到硬盘:下载功能的三步设置
下载功能默认关闭,所以第一步是去 设置 → 下载 里把它打开。之后批量存歌就两步:
- 在列表里多选歌曲:按住
Ctrl逐个点、Shift连续选、Ctrl+A全选 - 右键选下载,核对规则后确认
规则项的默认值都挺合理,知道在哪改就行:
- 文件名默认
歌名 - 歌手,可自定义 - 默认把封面写进文件,歌词可勾选写入,也能按列表名分目录存放
- 默认同时下载 3 首;磁盘上已有同名文件时自动跳过,不会重复下
- 下完的歌在"下载"页面继续管理,也可以直接从下载列表播放
下载时报ENOENT错误基本只有一个原因:设置的保存目录没有读写权限。换成用户主目录下自己新建的文件夹重试即可。
从手机和其他工具控制播放:局域网同步与开放 API
数据同步:在 PC 端 设置 → 数据同步 里启动本地服务,默认端口23332,手机端填入 PC 显示的地址后即可在局域网内互相同步歌单、列表和设置。传输是明文,只在可信网络下用;首次同步前先把列表备份一份更稳妥。手机端连不上时,在手机浏览器打开http://PC地址:23332/hello,页面能显示Hello~::^-^::就说明两端网络已互通,通不了多半是防火墙拦截或路由器开了 AP 隔离。
开放 API:设置 → 开放 API 开启后默认只监听127.0.0.1:23330,提供/play、/pause、/skip-next、/status、/lyric、/volume等 HTTP 端点,/subscribe-player-status还能以事件流形式持续接收播放状态,方便接自己的脚本或面板。想确认服务起没起来,跑一条命令即可:
curl http://127.0.0.1:23330/status
桌面歌词、主题与快捷键:把界面改成自己的样子
桌面歌词在 设置 → 桌面歌词 里开启,弹出独立小窗,默认 450×300。横竖排布、字号、已播/未播颜色都能调,位置可拖到屏幕任意角落,支持锁定和始终置顶;进入全屏或歌曲暂停时窗口会自动隐藏,不挡视线。
主题方面内置了水墨、月夜等风格,主题背景图就放在仓库的 src/common/theme/images/ 目录下,设置里还支持自建主题:
快捷键分应用内和全局两套,常用组合记这几组就够:
| 组合 | 作用 | 备注 |
|---|---|---|
F1 | 聚焦搜索框 | 应用内,默认开启 |
Ctrl+F5/Ctrl+←/Ctrl+→ | 播放暂停 / 上一曲 / 下一曲 | 应用内 |
Ctrl+Alt+F5 | 播放/暂停 | 全局,需在 设置 → 快捷键 开启 |
Ctrl+Alt+←/Ctrl+Alt+→ | 上一曲 / 下一曲 | 全局 |
Ctrl+Alt+↑/Ctrl+Alt+↓ | 音量 +/- | 全局 |
Ctrl+Alt+0 | 显示/隐藏桌面歌词 | 全局,另有Ctrl+Alt+-/Ctrl+Alt+=切锁定与置顶 |
全局快捷键默认是关的,打开后窗口失去焦点也能照常控制播放。
说到底,LX Music 只是个入口:搜得到的歌你免费听,想留下的歌你存得下,最后躺在硬盘里的文件归你所有,跟任何平台的会员资格都无关。
【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考