LX Music0 元装上一套多音源音乐库从搜索到下载 5 分钟跑通【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktopLX Music 桌面版是一款免费开源的多音源音乐播放器把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源装进同一个搜索框查找、试听、下载一次完成。它适合不想在多个平台反复切换、又想免费拿到完整音乐库的个人用户不花会员费本地存歌、离线播放、自定义音效全都有安装后基本开箱即用。第一幕从下载到播起来它是什么一张表看懂 LX Music项目说明技术栈Electron Vue 3 TypeScript本地数据用 better-sqlite3 存储许可证Apache License 2.0价格完全免费开源无任何会员支持平台Windows 7 及以上、macOS、LinuxAppImage / deb / rpm / pacman按系统挑对安装包Windows安装版setup支持自动更新绿色版green免安装但不支持自动更新长期用建议选安装版。macOS.dmg 格式Apple Silicon 与 Intel x64 分开发布按 CPU 架构选对应文件。Linux提供 AppImage、.deb、.rpm、.pacman 四种格式按发行版各取所需。⚠️ 坑Windows 安装版若当初以管理员身份安装后续自动升级可能出现卸载了旧版却装不上新版。修复重装时选择为当前用户安装并放在当前用户目录等无需管理员权限的位置。⚠️ 坑macOS 双击提示已损坏。修复终端执行一条命令移除隔离属性命令见第三幕排障表。首次启动要做的三件事确认设置里的自定义源脚本就位且可用。播放链接依赖源脚本没配好时所有歌都会提示请求异常看起来像软件故障其实是脚本问题。把下载路径从默认的桌面改到独立分区目录。不改的话下载容易报ENOENT: no such file or directory, mkdir原因基本是目录没有读写权限。若打算常用桌面歌词现在就在设置 → 桌面歌词里开启并选好字体免得用到时再翻找入口。第一次搜索与播放在顶部搜索框输入关键词结果带封面、歌手、音质128k / 320k / flac等信息右上方的下拉可切换当前音源某个源查不到歌换个源再试即可。单击歌曲是试听想连续播放多首按住Ctrl或Shift多选逻辑类似 Windows 文件选择右键添加到我的列表再播放。你点过的歌会自动进试听列表方便先快速过一遍再决定留下哪些。另外稍后播放是优先级最高的队列点下一曲时优先消耗它注意直接点击其他列表切歌会清空该队列。第二幕真实场景里用得上的能力离线听歌把喜欢的歌存成本地文件解决什么没网、断流或想反复听的歌下载后离线可放。怎么用在列表右键 → 下载可选音质、是否下载 LRC 与封面、是否把歌词内嵌进文件默认并发 3 个任务。入口在设置 → 下载可提前改好保存路径。提示下载目录权限不足会报ENOENT: ... mkdir换路径即可批量下载前先CtrlA全选再右键效率更高。音质与音效不动音源也能改听感解决什么默认音质不够听、想调 EQ 或加混响的场景。怎么用入口在播放栏的音效按钮内置均衡器、卷积混响模拟厅堂、房间声场等预设、音调偏移与 0.52 倍播放速度调好后可以另存为预设下次直接用。提示混响发送量sendGain默认是 0不开这个参数混响不会生效均衡器各频段默认全 0即不修正。桌面歌词与快捷键切窗口也能跟住歌词解决什么看代码、写文档时不想切回播放器窗口还要知道唱到哪一行。怎么用设置 → 桌面歌词开启独立歌词窗口支持字体选择、逐行播放样式、锁定位置与置顶播放栏进度条上的 LRC 按钮右键可快速锁定/解锁歌词窗口。提示全局快捷键默认关闭不手动打开不会生效本地快捷键在窗口聚焦时即可使用两者都能在设置 → 快捷键里重新映射。个性化主题、快捷键与数据目录内置多套背景主题也支持自定义导入入口在设置 → 主题设置快捷键分本地窗口聚焦时生效与全局系统级默认关闭两档默认绑定如下按键作用域功能ModF5本地播放 / 暂停Mod← / →本地上一曲 / 下一曲F1本地聚焦搜索框ModAltF5全局播放 / 暂停默认关ModAlt0全局显示 / 隐藏桌面歌词默认关Mod在 Windows/Linux 是CtrlmacOS 是Command。数据目录备份、迁移时看这里系统默认存储目录Windows%APPDATA%/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopLinux~/.config/lx-music-desktopWindows 下若程序目录里存在portable文件夹软件会自动改用它存放数据配合绿色版可以整套拷进 U 盘带走。自动化开放 API、Scheme 与自定义源解决什么想从脚本、浏览器或其他软件控制 LX Music 的场景。怎么用开放 API设置 → 开放 API 启用后本地起一个 HTTP 服务默认端口 23330第三方脚本即可控制播放、读取状态# 获取当前播放状态歌名、进度、歌词行等 curl http://127.0.0.1:23330/status # 暂停播放 curl http://127.0.0.1:23330/pause/subscribe-player-status接口用 SSE 实时推送歌词行、进度等字段做桌面歌词挂件很方便。Scheme 与启动参数lxmusic://支持从浏览器等外部场景调用搜索与播放快捷方式里加-search歌名或-playtypesongListsourcemyListname列表名开机即搜即播。自定义源源脚本是普通 JS 文件ES6通过事件机制与主程序通信声明支持的源与音质即可接入新音频源写请求的门槛不高。多端同步手机和电脑共用一套列表解决什么手机上存的列表想在电脑上继续用或反向同步。怎么用PC 端设置 → 数据同步开启局域网同步默认端口 23332移动端填入 PC 显示的同步服务器地址与端口后点启动同步两侧列表即可实时同步首次同步若两边都有内容会弹窗让你选择同步方式。有服务器的话v2.2.0 起可以自行部署独立同步服务组件拥有私有化的多端同步。提示同步数据是明文传输只在受信任的网络下用连不上时先确认防火墙没有拦截 23332 端口。第三幕出问题与想深挖高频故障排查速查表现象可能原因一步解决所有歌曲提示请求异常或EAI_AGAIN网络/DNS 无法访问接口服务器切移动热点验证DNS 改为223.6.6.6或8.8.8.8关闭软件内代理搜索正常但播放不出来或歌不对自定义源脚本过期更新源脚本或在设置中切换其他接口下载报ENOENT: ... mkdir下载目录无读写权限设置 → 下载中更换保存路径macOS 提示已损坏未签名应用被系统隔离终端执行sudo xattr -rd com.apple.quarantine /Applications/lx-music-desktop.appWindows 10/11 窗口不显示GPU 沙箱兼容问题快捷方式加启动参数--disable-gpu-sandbox无效再逐个尝试-dha、--disable-gpu排行榜、歌单、搜索全部加载不出来设置 → 网络里的代理配错进入设置 → 网络把代理关掉再试参与开发约定与代码地图项目欢迎 PR两条约定新功能先开 Issue 确认必要性修 bug 的 PR 要附重现方式与修复前后说明。开发环境最低要求 Node.js ≥ 22、npm ≥ 8.5.2克隆仓库后在dev分支开发并向dev提交 PRgit clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop想读源码从这几个目录入手主进程模块窗口、IPC、同步服务、开放 API、界面代码搜索、列表、播放、桌面歌词窗口、五音源接口实现。想加新音乐源先读 musicSdk 下对应音源的目录。写在最后一个搜索框加一个音源下拉覆盖了大部分找歌需求这是 LX Music 最核心的价值。它适合愿意自己折腾一点配置、又想把找歌、听歌、存歌的成本压到零的用户项目定位是技术研究使用中产生的版权数据建议及时清理长期使用也请支持正版。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考