LX Music 桌面版使用指南：免费多音源播放器，5 大音源装进一个搜索框，0 元听歌不折腾

LX Music 桌面版使用指南免费多音源播放器5 大音源装进一个搜索框0 元听歌不折腾【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop把同一首歌在几个 App 之间来回找、为高音质掏会员费这种消耗可以省掉。LX Music 桌面版是一款免费开源的多音源音乐播放器把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源聚合进同一个搜索框搜索、试听、下载在一个窗口内完成。它用 Electron Vue 3 TypeScript 构建本地数据走 better-sqlite3采用 Apache License 2.0 协议覆盖 Windows 7 及以上、macOS 和 Linux。这篇指南按装软件 → 调设置 → 上手播放 → 效率玩法 → 出问题怎么办的顺序讲每步都给出具体入口。先装对Windows、macOS、Linux 的安装包怎么选Windows 分两种形态安装版setup和绿色版green。区别在于自动更新——安装版能走更新通道绿色版不能。打算长期用就选安装版只是临时尝鲜绿色版解压即用。macOS 只提供 .dmg但按 CPU 架构分两个包Apple Silicon 选 arm64Intel x64 选 x64装错架构会白忙一场。Linux 提供 AppImage、.deb、.rpm、.pacman 四种格式按发行版取对应的一种即可AppImage 是通用兜底方案。Windows 安装身份会决定日后的升级体验。如果安装时选择了为所有用户安装即以管理员身份后续自动升级可能出现旧版卸载了、新版装不上的卡死状态。判断依据很简单升级日志显示卸载成功但安装失败。解法是重新安装时勾选为当前用户安装并把程序放在当前用户目录下避开系统目录的权限差异。第一次打开三处设置决定后面顺不顺软件默认配置偏老手向第一次启动建议先把下面三处过一遍。音源所有播放请求的命门播放链接依赖自定义源脚本来解析首次启动先确认源脚本就位且能正常返回。典型症状是所有歌曲都提示请求异常——注意这大概率不是软件坏了而是脚本失效或当前网络不通先别急着重装。下载路径别留在桌面默认下载位置是桌面。建议改到一个独立分区或专门的目录理由有二一是桌面路径容易受 OneDrive 之类同步工具干扰二是权限问题会直接暴露成报错。后续如果下载任务抛出ENOENT: no such file or directory, mkdir判断依据就是目标目录没有读写权限回到设置 → 下载里换路径即可。桌面歌词提前开比事后找快如果确定要用独立歌词窗口直接在设置 → 桌面歌词里开启顺手把字体和排版定好。平时切换用全局快捷键见下文播放栏 LRC 按钮上右键还能快速锁定歌词位置。顺手检查代理配置设置 → 网络里的代理如果配错比如残留了一个已失效的代理地址整个软件会直接断网排行榜、歌单、搜索全部加载不出来。排查网络问题前先确认这里没有被误改。搜一首歌从关键词到听完整首的完整路径顶部搜索框输入关键词右上角下拉切换当前音源。结果列表带封面、歌手和音质信息128k / 320k / flac。某个源查不到时换个源再搜一次五个源互相兜底这就是聚合的价值。播放交互的默认逻辑和新用户习惯不太一样值得提前知道单击歌曲 试听这一首想连播多首按住Ctrl不连续选或Shift连续选多选操作逻辑类似 Windows 文件选择然后右键添加到我的列表再播放你点过的歌会自动进试听列表适合快速过一遍再决定留下哪些CtrlA全选后右键可批量添加、批量下载。稍后播放队列有两条规则它是优先级最高的队列点下一曲时优先消耗其中内容但只要你直接点击其他列表里的歌曲切歌这个队列会被清空。想用它攒歌就别用点歌切歌的方式换曲。日常用法下载、音效与桌面歌词离线下载列表右键 → 下载。可选项目音质、是否下载 LRC、是否下载封面、是否把歌词内嵌进文件。任务默认 3 个并发批量下载时不用盯着。下载目录相关的所有选项集中在设置 → 下载。音效面板播放栏的音效入口里集中了几项处理能力均衡器多段频率调节、卷积混响内置厅堂、房间等声场模拟源码里的冲激响应素材在 src/renderer/assets/medias/filters/、音调偏移以及 0.52 倍的播放速度。对音源本身音质不满意时混响和均衡器能救回一部分听感。桌面歌词窗口独立窗口支持字体选择、逐行播放样式、位置锁定与始终置顶。入口在设置 → 桌面歌词播放中想临时固定位置右键播放栏 LRC 按钮即可。歌词窗口的界面与逻辑在 src/renderer-lyric/ 下渲染与主窗口完全解耦。快捷键本地与全局两档本地键在窗口聚焦时生效全局键是系统级默认关闭开启后切到别的窗口也能控制。默认绑定如下按键作用域功能ModF5本地播放 / 暂停Mod← / Mod→本地上一曲 / 下一曲F1本地聚焦搜索框ModAltF5全局播放 / 暂停默认关ModAlt0全局显示 / 隐藏桌面歌词默认关Mod在 Windows/Linux 上就是CtrlmacOS 上是Command。全部按键可以在设置 → 快捷键里重新映射。效率玩法命令行、Scheme 与开放 API快捷方式带参数启动在桌面快捷方式的目标后面追加启动参数双击就能直达内容-search歌名启动即搜索-playtypesongListsourcemyListname列表名启动即播放指定列表。另外lxmusic://Scheme 支持从浏览器等外部场景发起搜索与播放配合网页环境使用很顺。开放 API让第三方脚本控制播放器在设置 → 开放 API 里启用后软件本地起一个 HTTP 服务默认端口 23330。两条最常用的接口curl http://127.0.0.1:23330/status # 当前播放状态歌名、进度、歌词行等 curl http://127.0.0.1:23330/pause # 暂停播放/subscribe-player-status接口走 SSE 实时推送歌词行、进度等字段拿它做一个桌面歌词挂件或状态小组件相当方便。相关实现位于 src/main/modules/openApi/。主题与数据目录换皮和备份都在这主题库内置多套背景也支持自定义导入入口在设置 → 主题设置。下面是仓库里自带的几张数据目录备份、迁移时要用系统默认存储目录Windows%APPDATA%/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopLinux~/.config/lx-music-desktopWindows 上有个便携特性程序目录里如果存在名为portable的文件夹软件会自动改用它存数据。配合绿色版整套配置可以拷进 U 盘带走。出问题时的排查顺序按症状 → 判断依据 → 解法对号入座症状所有歌曲提示请求异常或EAI_AGAIN。判断网络或 DNS 访问不到接口服务器与软件本身无关。解法先切手机热点验证DNS 改成223.6.6.6或8.8.8.8同时确认软件内没有配置错误的代理。症状搜索正常但播放不出或放出来的歌不对。判断自定义源脚本过期接口行为变了。解法更新源脚本或在设置中切换到其他接口。症状下载任务报ENOENT: ... mkdir。判断下载目录没有读写权限。解法设置 → 下载中更换路径。症状macOS 打开应用提示已损坏。判断未签名应用被系统加了隔离属性。解法终端执行sudo xattr -rd com.apple.quarantine针对该 .app 路径移除隔离。症状Windows 10/11 下窗口不显示。判断GPU 沙箱兼容问题。解法快捷方式追加启动参数--disable-gpu-sandbox仍无效再逐个尝试-dha、--disable-gpu。更多问题可以参考仓库自带的 FAQ.md。想动手改参与开发的最小路径项目接受外部贡献两条约定要遵守新功能先开 Issue 确认必要性修 bug 的 PR 必须附重现方式和修复前后说明。开发环境最低要求Node.js ≥ 22npm ≥ 8.5.2。git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop在 dev 分支上开发并向 dev 提 PR。核心代码都在src/下分工很清晰主进程窗口、IPC、同步服务、开放 API在 src/main/主界面在 src/renderer/桌面歌词窗口在 src/renderer-lyric/五个音源的接口实现集中在 src/renderer/utils/musicSdk/——想加新音乐源从对应目录读起就对了。数据同步方面v2.2.0 起提供独立同步服务组件自行部署可获得私有化多端同步软件内置的局域网同步默认端口 23332则适合和移动版在同一个路由器下快速同步列表实现在 src/main/modules/sync/。最后说两句回到开头那个多平台横跳的场景一个搜索框加一个音源下拉已经能覆盖大部分查找需求——这也是这个项目的核心价值免费、完整、可自己扩展。但要清楚它的定位是技术研究搜索和下载产生的版权数据要及时清理长期使用的话还是建议支持正版。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考