LX Music 桌面版使用指南五个音源合一个搜索框从安装到听歌的全流程【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop装好软件到听上第一首歌两分钟足够下载对应系统的安装包双击启动在搜索框输入歌名点开结果里第一首就是声音。LX Music 是一款免费开源的多音源音乐播放器把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源聚合进同一个搜索框技术栈为 Electron 40 Vue 3 TypeScript本地数据由 better-sqlite3 落盘采用 Apache-2.0 许可证覆盖 Windows、macOSApple Silicon / Intel 双架构与 Linux。 快速上手从下载到第一首歌的最短路径选对安装包Windows 有安装版与绿色版green两种安装版支持自动更新长期使用优先选它macOS 是 .dmg按 CPU 架构选 arm64 或 x64Linux 提供 AppImage、.deb、.rpm、.pacman 四种格式各发行版按需取用。Windows 安装时建议选为当前用户安装避免以管理员身份装完后自动升级出现旧版卸了、新版装不上的尴尬。三处初始设置都在 设置 面板里下载路径默认是桌面os.homedir()/Desktop建议改成独立分区目录避免后续下载报ENOENT ... mkdir网络代理确认没有残留配置代理配错会导致搜索、歌单、排行榜全部加载失败桌面歌词若打算常用趁早开启并设置字体入口设置 → 桌面歌词默认未启用。首次搜索顶部搜索框输入关键词结果带封面、歌手与可选音质顶部下拉可切换当前音源单击即可试听右键可把歌曲加入列表再连续播放。如果所有歌曲都提示请求异常先检查源脚本是否可用见避坑一节。 找歌多音源搜索与列表玩法一个框搜五个源搜索时按所选音源检索某个源查不到就换个源再试。源码层面五个音源的接口实现各自独立存放在 musicSdk 目录kw酷我、kg酷狗、txQQ、wy网易云、mg咪咕另有虾米保留在代码中但不参与聚合搜索。多选入列表与试听列表按住Ctrl或Shift多选歌曲操作逻辑类似 Windows 资源管理器右键添加到列表即可成批收藏CtrlA支持全选单击试听的歌曲会自动进入稍后播放队列适合先快速过一遍再决定去留队列机制值得留意点下一曲时优先消耗稍后播放队列而直接点其他列表切歌会清空它。排行榜与歌单除歌曲外各音源的排行榜、歌单同样可搜索浏览歌单可整体加入我的列表支持拖拽调整列表顺序Ctrl 拖动。 存歌下载与本地管理下载能力入口列表歌曲右键 → 下载先在设置 → 下载中启用选项说明音质128k / 320k / flac 等按源支持情况可选歌词可勾选下载 LRC含翻译、罗马音、lx 增强版并可内嵌进音频文件封面可内嵌封面图片并发数默认同时 3 个任务download.maxDownloadNum文件名默认歌名 - 歌手可选按列表名分子目录存放默认还会跳过已存在的文件重复下载不占空间。数据目录与备份迁移系统数据目录Windows%APPDATA%/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopLinux~/.config/lx-music-desktop备份或换机时整体拷贝该目录即可带走列表、设置与下载记录。Windows 下若程序目录里存在名为portable的文件夹软件会自动改用它存放数据——配合绿色版可以整套拷进 U 盘。 体验主题、桌面歌词、音效与快捷键主题内置多套背景可切换也支持自定义导入入口在设置 → 主题。下面这套水墨风格就是仓库自带的素材另有一张极简月夜图适合深夜听歌场景桌面歌词独立小窗默认 450×300支持横排/竖排、字体与字号、行距、已唱/未唱颜色、置顶、锁位、全屏或暂停时自动隐藏在播放栏歌词按钮上右键也能快速开关锁定。独立渲染窗口代码在 renderer-lyric 目录。音效播放栏音效入口内置多段均衡器31Hz–16kHz 共 10 段、卷积混响预设厅堂、房间等声场、音调偏移与 0.52 倍播放速度。快捷键分本地窗口聚焦生效与全局系统级默认关闭两档默认绑定按键作用域功能CtrlF5本地播放 / 暂停Ctrl←/Ctrl→本地上一曲 / 下一曲F1本地聚焦搜索框CtrlAltF5/CtrlAlt←→全局播放控制默认关CtrlAlt0全局显示 / 隐藏桌面歌词默认关Ctrl在 macOS 上对应Command两档按键均可在设置 → 快捷键中重新映射全局档还支持音量与歌词锁位/置顶切换。 整合让别的软件接进来启动参数与 Scheme给桌面快捷方式加参数可以做到开软件即播-search突然的自我 - 伍佰此外lxmusic://Scheme 支持外部程序如浏览器调用搜索与播放规则见 FAQ 文档。开放 API设置 → 开放 API 启用后本地起一个 HTTP 服务默认端口 23330可勾选绑定局域网# 查询当前播放状态 curl http://127.0.0.1:23330/status # 暂停 / 下一曲 curl http://127.0.0.1:23330/pause curl http://127.0.0.1:23330/skip-next/subscribe-player-status走 SSE 持续推送歌词行、进度等字段做桌面歌词挂件或小屏幕状态屏很顺手。服务端实现位于 openApi 模块。自定义源脚本播放地址解析依赖自定义源脚本普通 JS 文件ES6脚本失效是请求异常的第一嫌疑人更新脚本即可恢复。想接新音源也可以照着 musicSdk 目录 里现有源的结构写。多端同步内置局域网同步服务默认端口 23332同一路由器下与移动版同步列表另有独立的同步服务组件可自部署实现跨网络的私有化多端同步。⚠️ 避坑高频故障速查症状原因处理所有歌曲提示请求异常或EAI_AGAINDNS/网络无法访问接口或源脚本失效换热点验证DNS 改223.6.6.6关闭软件内代理更新自定义源脚本搜索正常但播放失败或歌不对源脚本过期更新源脚本或在设置中切换其他接口下载报ENOENT ... mkdir下载目录无读写权限设置 → 下载中更换路径搜索、歌单、排行榜全部加载不出来代理配置错误设置 → 网络中检查并清空代理macOS 提示已损坏未签名应用被系统隔离终端执行sudo xattr -rd com.apple.quarantine移除隔离属性Windows 10/11 窗口不显示GPU 沙箱兼容问题快捷方式加--disable-gpu-sandbox无效再试-dha、--disable-gpu升级后旧版卸载但新版装不上当初以管理员身份安装重装并选为当前用户安装放在当前用户目录 参与贡献环境要求 Node.js ≥ 22、npm ≥ 8.5.2。代码结构主进程窗口、IPC、同步服务、开放 API在 src/main/界面在 src/renderer/五音源接口在 src/renderer/utils/musicSdk/。约定两条新功能先开 Issue 确认必要性修 bug 的 PR 附重现方式与修复前后说明。git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop写在最后回到开头那条两分钟的路径下载、启动、搜索、试听——一个搜索框加一个音源下拉已经能覆盖日常绝大多数找歌场景想留下的歌下载下来存进自己的目录换机时拷走数据目录就行。最后提醒一句项目定位是技术研究使用中产生的版权内容请及时清理长期听歌建议支持正版。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 LX Music 桌面版使用指南：五个音源合一个搜索框，从安装到听歌的全流程
LX Music 桌面版使用指南五个音源合一个搜索框从安装到听歌的全流程【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop装好软件到听上第一首歌两分钟足够下载对应系统的安装包双击启动在搜索框输入歌名点开结果里第一首就是声音。LX Music 是一款免费开源的多音源音乐播放器把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源聚合进同一个搜索框技术栈为 Electron 40 Vue 3 TypeScript本地数据由 better-sqlite3 落盘采用 Apache-2.0 许可证覆盖 Windows、macOSApple Silicon / Intel 双架构与 Linux。 快速上手从下载到第一首歌的最短路径选对安装包Windows 有安装版与绿色版green两种安装版支持自动更新长期使用优先选它macOS 是 .dmg按 CPU 架构选 arm64 或 x64Linux 提供 AppImage、.deb、.rpm、.pacman 四种格式各发行版按需取用。Windows 安装时建议选为当前用户安装避免以管理员身份装完后自动升级出现旧版卸了、新版装不上的尴尬。三处初始设置都在 设置 面板里下载路径默认是桌面os.homedir()/Desktop建议改成独立分区目录避免后续下载报ENOENT ... mkdir网络代理确认没有残留配置代理配错会导致搜索、歌单、排行榜全部加载失败桌面歌词若打算常用趁早开启并设置字体入口设置 → 桌面歌词默认未启用。首次搜索顶部搜索框输入关键词结果带封面、歌手与可选音质顶部下拉可切换当前音源单击即可试听右键可把歌曲加入列表再连续播放。如果所有歌曲都提示请求异常先检查源脚本是否可用见避坑一节。 找歌多音源搜索与列表玩法一个框搜五个源搜索时按所选音源检索某个源查不到就换个源再试。源码层面五个音源的接口实现各自独立存放在 musicSdk 目录kw酷我、kg酷狗、txQQ、wy网易云、mg咪咕另有虾米保留在代码中但不参与聚合搜索。多选入列表与试听列表按住Ctrl或Shift多选歌曲操作逻辑类似 Windows 资源管理器右键添加到列表即可成批收藏CtrlA支持全选单击试听的歌曲会自动进入稍后播放队列适合先快速过一遍再决定去留队列机制值得留意点下一曲时优先消耗稍后播放队列而直接点其他列表切歌会清空它。排行榜与歌单除歌曲外各音源的排行榜、歌单同样可搜索浏览歌单可整体加入我的列表支持拖拽调整列表顺序Ctrl 拖动。 存歌下载与本地管理下载能力入口列表歌曲右键 → 下载先在设置 → 下载中启用选项说明音质128k / 320k / flac 等按源支持情况可选歌词可勾选下载 LRC含翻译、罗马音、lx 增强版并可内嵌进音频文件封面可内嵌封面图片并发数默认同时 3 个任务download.maxDownloadNum文件名默认歌名 - 歌手可选按列表名分子目录存放默认还会跳过已存在的文件重复下载不占空间。数据目录与备份迁移系统数据目录Windows%APPDATA%/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktopLinux~/.config/lx-music-desktop备份或换机时整体拷贝该目录即可带走列表、设置与下载记录。Windows 下若程序目录里存在名为portable的文件夹软件会自动改用它存放数据——配合绿色版可以整套拷进 U 盘。 体验主题、桌面歌词、音效与快捷键主题内置多套背景可切换也支持自定义导入入口在设置 → 主题。下面这套水墨风格就是仓库自带的素材另有一张极简月夜图适合深夜听歌场景桌面歌词独立小窗默认 450×300支持横排/竖排、字体与字号、行距、已唱/未唱颜色、置顶、锁位、全屏或暂停时自动隐藏在播放栏歌词按钮上右键也能快速开关锁定。独立渲染窗口代码在 renderer-lyric 目录。音效播放栏音效入口内置多段均衡器31Hz–16kHz 共 10 段、卷积混响预设厅堂、房间等声场、音调偏移与 0.52 倍播放速度。快捷键分本地窗口聚焦生效与全局系统级默认关闭两档默认绑定按键作用域功能CtrlF5本地播放 / 暂停Ctrl←/Ctrl→本地上一曲 / 下一曲F1本地聚焦搜索框CtrlAltF5/CtrlAlt←→全局播放控制默认关CtrlAlt0全局显示 / 隐藏桌面歌词默认关Ctrl在 macOS 上对应Command两档按键均可在设置 → 快捷键中重新映射全局档还支持音量与歌词锁位/置顶切换。 整合让别的软件接进来启动参数与 Scheme给桌面快捷方式加参数可以做到开软件即播-search突然的自我 - 伍佰此外lxmusic://Scheme 支持外部程序如浏览器调用搜索与播放规则见 FAQ 文档。开放 API设置 → 开放 API 启用后本地起一个 HTTP 服务默认端口 23330可勾选绑定局域网# 查询当前播放状态 curl http://127.0.0.1:23330/status # 暂停 / 下一曲 curl http://127.0.0.1:23330/pause curl http://127.0.0.1:23330/skip-next/subscribe-player-status走 SSE 持续推送歌词行、进度等字段做桌面歌词挂件或小屏幕状态屏很顺手。服务端实现位于 openApi 模块。自定义源脚本播放地址解析依赖自定义源脚本普通 JS 文件ES6脚本失效是请求异常的第一嫌疑人更新脚本即可恢复。想接新音源也可以照着 musicSdk 目录 里现有源的结构写。多端同步内置局域网同步服务默认端口 23332同一路由器下与移动版同步列表另有独立的同步服务组件可自部署实现跨网络的私有化多端同步。⚠️ 避坑高频故障速查症状原因处理所有歌曲提示请求异常或EAI_AGAINDNS/网络无法访问接口或源脚本失效换热点验证DNS 改223.6.6.6关闭软件内代理更新自定义源脚本搜索正常但播放失败或歌不对源脚本过期更新源脚本或在设置中切换其他接口下载报ENOENT ... mkdir下载目录无读写权限设置 → 下载中更换路径搜索、歌单、排行榜全部加载不出来代理配置错误设置 → 网络中检查并清空代理macOS 提示已损坏未签名应用被系统隔离终端执行sudo xattr -rd com.apple.quarantine移除隔离属性Windows 10/11 窗口不显示GPU 沙箱兼容问题快捷方式加--disable-gpu-sandbox无效再试-dha、--disable-gpu升级后旧版卸载但新版装不上当初以管理员身份安装重装并选为当前用户安装放在当前用户目录 参与贡献环境要求 Node.js ≥ 22、npm ≥ 8.5.2。代码结构主进程窗口、IPC、同步服务、开放 API在 src/main/界面在 src/renderer/五音源接口在 src/renderer/utils/musicSdk/。约定两条新功能先开 Issue 确认必要性修 bug 的 PR 附重现方式与修复前后说明。git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop写在最后回到开头那条两分钟的路径下载、启动、搜索、试听——一个搜索框加一个音源下拉已经能覆盖日常绝大多数找歌场景想留下的歌下载下来存进自己的目录换机时拷走数据目录就行。最后提醒一句项目定位是技术研究使用中产生的版权内容请及时清理长期听歌建议支持正版。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考