LX Music 快速上手如何用一个搜索框搜遍5大音源并搭建本地曲库【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktopLX Music 是一款基于 Electron 30 与 Vue 3 的开源音乐播放器把酷我、酷狗、QQ音乐、网易云、咪咕 5 个音源的在线数据汇进同一个搜索框试听最高支持 flac24bit 音质还能批量下载并写入封面与歌词。下面按实际使用顺序讲清楚安装包怎么选、歌怎么存进本地、出了问题怎么查、怎么把主题和歌词窗调到自己顺手最后再说数据同步与开放 API 这类进阶玩法。怎么挑 LX Music 安装包先回答3个问题问题一你的系统是什么系统安装包后缀说明Windows 7 及以上Setup安装版/ green绿色版安装版带自动更新绿色版需手动换包macOS.dmg解压拖入应用程序即可Linux.deb / .rpm / .AppImage / .pacman按发行版对应的包管理器选问题二系统是 32 位还是 64 位文件名带x64对应 64 位、x86对应 32 位、arm对应 ARM 架构同时标注两者的集合版会在安装时自动匹配位数。问题三装在哪Windows 版从 v1.17.0 起支持便携模式程序所在文件夹里多一个portable文件夹配置和列表就全部写进该文件夹整个目录拷进 U 盘即可带走。其他平台的数据默认存放在系统固定目录文末有速查表。装好后启动界面就四块左侧导航搜索、排行榜、我的列表、下载、设置、顶部搜索框、中部歌曲列表、底部播放控制栏。按F1直接跳到搜索框后面所有操作都从这里开始。从搜歌到入曲库如何打开 LX Music 批量下载搜。输入歌名回车五个音源的结果会合并成一张列表不用先挑平台。每条结果旁边标着当前可下载的音质档位128k、320k、flac、flac24bit。听。点任意一条直接播放。注意一个机制你从搜索结果、歌单或排行榜里点歌时这首歌会自动先进入我的列表里的试听列表再开始播所以听过什么之后都能去我的列表翻到不用重新搜。存。批量下载默认是关着的第一次用之前先去设置 → 下载把开关打开。然后返回列表多选Shift点两端做连续选择Ctrl点单项做跳跃选择CtrlA全选选中后右键 → 下载。默认值对照下面这份清单确认即可全部在设置 → 下载里可改代码出处见 src/common/defaultSetting.ts文件命名歌名 - 歌手下载目录桌面并行任务数3网络好可往上加同名文件跳过已存在的重跑任务不会覆盖旧文件封面写入音频默认开启想省空间再关歌词lxlrc 格式默认嵌入普通 lrc、翻译、罗马音需分别手动勾选按列表名分目录默认关闭想按歌单整理曲库时再开任务结束后到下载页面统一处理能播放、能补跑失败任务也能右键把已下歌曲加回列表。卡住了怎么办4个常见症状与自查方法排障时先分清接口问题和本机问题下面四组症状基本覆盖了绝大多数情况详细背景可看 FAQ.md。症状整页搜索刷不出来歌曲一律提示请求异常判断接口源不可用或本机 DNS、网络到不了接口服务器。 处理先设置 → 音乐来源换一个接口源再连手机热点验证是否网络自身的问题还不行就把 DNS 改成223.6.6.6或8.8.8.8重启软件再试。症状Windows 上所有歌曲提示音频加载错误5秒后切换下一首判断多半是系统代理设置干扰了音频流。 处理按WinR输入inetcpl.cpl在 Internet 选项的连接 → 局域网设置里把代理服务器和自动配置的勾选去掉确定后重启软件。症状Windows 10/11 界面整屏空白或显示不全判断GPU 沙箱与显卡驱动冲突属渲染层问题与数据无关。 处理给快捷方式加启动参数--disable-gpu-sandbox无效就依次试--no-sandbox、-dha、--disable-gpu哪个恢复显示就用哪个。这类参数会削弱安全特性问题解决后建议去掉。症状下载报错ENOENT: no such file or directory, mkdir判断所选下载目录没有读写权限连建文件夹都失败。 处理把下载目录换成有权限的路径例如用户主目录下自己新建的文件夹。主题与桌面歌词如何把 LX Music 调到自己顺手音质档位。四个档位 128k / 320k / flac / flac24bit 在设置 → 播放里选默认 128k日常够用且省流量网络条件好再调高。同页有个值得留意的开关出错自动跳过默认开启——某首歌加载失败时直接切下一首不用你手动干预。主题。内置十五套主题一键切换名字挺有趣绿意盎然、蓝田生玉、月里嫦娥、近墨者黑、新年快乐春节时段会自动换上它等。想自己搞一套也行设置里自建主题拖一张背景图、配一个主色即可。内置主题的背景图都在 src/common/theme/images/ 目录效果如下桌面歌词。在设置 → 桌面歌词里开启后它会以独立于主窗口的形式出现默认尺寸 450×300。可参数化调整横排或竖排、字号、已播/未播歌词颜色、窗口透明度。窗口本身支持锁定位置和始终置顶拖到屏幕任意角落主窗口进全屏或歌曲暂停时它默认自动隐藏不挡屏幕。快捷键分应用内和全局两套都在设置 → 快捷键里管理应用内默认启用F1聚焦搜索框CtrlF5播放/暂停Ctrl←/Ctrl→上一曲/下一曲另有F11进入或退出全屏全局默认关闭打开后窗口失焦也能控CtrlAltF5播放/暂停CtrlAlt←/→切歌CtrlAlt↑/↓音量加减CtrlAlt0桌面歌词显隐macOS 上Ctrl一律对应Cmd。建议至少把全局的播放/暂停和歌词显隐两项打开切窗口时还能顺手控制播放。进阶玩法如何开启 LX Music 数据同步与开放 API两项功能都在设置里、默认全部关闭用到再开。数据同步。在设置 → 数据同步里启动本地服务默认监听端口23332手机端在同步设置里填入 PC 显示的局域网地址即可歌单、列表、设置会在多台设备间互相同步。两点提醒传输是明文只放在可信局域网里用首次同步前先把列表备份一次同步出问题时能回滚。连通性检查很简单手机浏览器打开http://PC地址:23332/hello能显示欢迎语就说明两端网络已互通。服务端实现见 src/main/modules/sync/。开放 API。在设置 → 开放 API里开启后软件会起一个 HTTP 服务默认只监听127.0.0.1:23330即只接受本机调用需要局域网访问再打开 bindLan 开关。对外暴露/status、/play、/pause、/skip-next、/skip-prev、/seek、/volume、/mute、/collect、/uncollect、/lyric、/lyric-all等端点/subscribe-player-status以 SSE 事件流持续推送播放状态默认推送歌名、歌手、专辑、当前歌词行、时长、进度、倍速等字段拿它做歌词桌宠、状态面板最方便。实现代码见 src/main/modules/openApi/。服务起来后本机一条命令验证curl http://127.0.0.1:23330/status返回当前播放状态的 JSON 就说明端点可用。自定义音源。给 LX Music 加新音源的方式是准备一个 JavaScript 脚本在设置里导入脚本声明支持的源与musicUrl动作运行时监听应用发来的请求被点名时返回该歌曲的 http/https 直链。脚本里可以直接用lx.request发 HTTP 请求不受跨域限制且跟随软件内的代理设置加解密方面自带 AES、MD5、RSA 等工具函数应付大多数音源接口的签名逻辑够了。运行时实现在 src/main/modules/userApi/。适合给某个平台配专属音源或在默认音源不稳定时留一条备用链路。LX Music 数据存在哪里配置、列表、下载缓存都落在平台固定的数据目录里Windows%APPDATA%/lx-music-desktopLinux~/.config/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktop例外Windows 版v1.17.0 及以上程序目录下有portable文件夹时数据直接写进该文件夹给新手的三句落地建议第一次用选 Windows 安装版更新提示是现成的出问题基本都卡在接口源上按换源 → 换网 → 改 DNS的顺序排查别跳步想深挖就先把开放 API 开起来自定义音源和桌面歌词都建立在这套本地服务之上。版本变化可查 CHANGELOG.md。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/31 1:26:56 · 阅读 1.2k LX Music 快速上手：如何用一个搜索框搜遍5大音源并搭建本地曲库
LX Music 快速上手如何用一个搜索框搜遍5大音源并搭建本地曲库【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktopLX Music 是一款基于 Electron 30 与 Vue 3 的开源音乐播放器把酷我、酷狗、QQ音乐、网易云、咪咕 5 个音源的在线数据汇进同一个搜索框试听最高支持 flac24bit 音质还能批量下载并写入封面与歌词。下面按实际使用顺序讲清楚安装包怎么选、歌怎么存进本地、出了问题怎么查、怎么把主题和歌词窗调到自己顺手最后再说数据同步与开放 API 这类进阶玩法。怎么挑 LX Music 安装包先回答3个问题问题一你的系统是什么系统安装包后缀说明Windows 7 及以上Setup安装版/ green绿色版安装版带自动更新绿色版需手动换包macOS.dmg解压拖入应用程序即可Linux.deb / .rpm / .AppImage / .pacman按发行版对应的包管理器选问题二系统是 32 位还是 64 位文件名带x64对应 64 位、x86对应 32 位、arm对应 ARM 架构同时标注两者的集合版会在安装时自动匹配位数。问题三装在哪Windows 版从 v1.17.0 起支持便携模式程序所在文件夹里多一个portable文件夹配置和列表就全部写进该文件夹整个目录拷进 U 盘即可带走。其他平台的数据默认存放在系统固定目录文末有速查表。装好后启动界面就四块左侧导航搜索、排行榜、我的列表、下载、设置、顶部搜索框、中部歌曲列表、底部播放控制栏。按F1直接跳到搜索框后面所有操作都从这里开始。从搜歌到入曲库如何打开 LX Music 批量下载搜。输入歌名回车五个音源的结果会合并成一张列表不用先挑平台。每条结果旁边标着当前可下载的音质档位128k、320k、flac、flac24bit。听。点任意一条直接播放。注意一个机制你从搜索结果、歌单或排行榜里点歌时这首歌会自动先进入我的列表里的试听列表再开始播所以听过什么之后都能去我的列表翻到不用重新搜。存。批量下载默认是关着的第一次用之前先去设置 → 下载把开关打开。然后返回列表多选Shift点两端做连续选择Ctrl点单项做跳跃选择CtrlA全选选中后右键 → 下载。默认值对照下面这份清单确认即可全部在设置 → 下载里可改代码出处见 src/common/defaultSetting.ts文件命名歌名 - 歌手下载目录桌面并行任务数3网络好可往上加同名文件跳过已存在的重跑任务不会覆盖旧文件封面写入音频默认开启想省空间再关歌词lxlrc 格式默认嵌入普通 lrc、翻译、罗马音需分别手动勾选按列表名分目录默认关闭想按歌单整理曲库时再开任务结束后到下载页面统一处理能播放、能补跑失败任务也能右键把已下歌曲加回列表。卡住了怎么办4个常见症状与自查方法排障时先分清接口问题和本机问题下面四组症状基本覆盖了绝大多数情况详细背景可看 FAQ.md。症状整页搜索刷不出来歌曲一律提示请求异常判断接口源不可用或本机 DNS、网络到不了接口服务器。 处理先设置 → 音乐来源换一个接口源再连手机热点验证是否网络自身的问题还不行就把 DNS 改成223.6.6.6或8.8.8.8重启软件再试。症状Windows 上所有歌曲提示音频加载错误5秒后切换下一首判断多半是系统代理设置干扰了音频流。 处理按WinR输入inetcpl.cpl在 Internet 选项的连接 → 局域网设置里把代理服务器和自动配置的勾选去掉确定后重启软件。症状Windows 10/11 界面整屏空白或显示不全判断GPU 沙箱与显卡驱动冲突属渲染层问题与数据无关。 处理给快捷方式加启动参数--disable-gpu-sandbox无效就依次试--no-sandbox、-dha、--disable-gpu哪个恢复显示就用哪个。这类参数会削弱安全特性问题解决后建议去掉。症状下载报错ENOENT: no such file or directory, mkdir判断所选下载目录没有读写权限连建文件夹都失败。 处理把下载目录换成有权限的路径例如用户主目录下自己新建的文件夹。主题与桌面歌词如何把 LX Music 调到自己顺手音质档位。四个档位 128k / 320k / flac / flac24bit 在设置 → 播放里选默认 128k日常够用且省流量网络条件好再调高。同页有个值得留意的开关出错自动跳过默认开启——某首歌加载失败时直接切下一首不用你手动干预。主题。内置十五套主题一键切换名字挺有趣绿意盎然、蓝田生玉、月里嫦娥、近墨者黑、新年快乐春节时段会自动换上它等。想自己搞一套也行设置里自建主题拖一张背景图、配一个主色即可。内置主题的背景图都在 src/common/theme/images/ 目录效果如下桌面歌词。在设置 → 桌面歌词里开启后它会以独立于主窗口的形式出现默认尺寸 450×300。可参数化调整横排或竖排、字号、已播/未播歌词颜色、窗口透明度。窗口本身支持锁定位置和始终置顶拖到屏幕任意角落主窗口进全屏或歌曲暂停时它默认自动隐藏不挡屏幕。快捷键分应用内和全局两套都在设置 → 快捷键里管理应用内默认启用F1聚焦搜索框CtrlF5播放/暂停Ctrl←/Ctrl→上一曲/下一曲另有F11进入或退出全屏全局默认关闭打开后窗口失焦也能控CtrlAltF5播放/暂停CtrlAlt←/→切歌CtrlAlt↑/↓音量加减CtrlAlt0桌面歌词显隐macOS 上Ctrl一律对应Cmd。建议至少把全局的播放/暂停和歌词显隐两项打开切窗口时还能顺手控制播放。进阶玩法如何开启 LX Music 数据同步与开放 API两项功能都在设置里、默认全部关闭用到再开。数据同步。在设置 → 数据同步里启动本地服务默认监听端口23332手机端在同步设置里填入 PC 显示的局域网地址即可歌单、列表、设置会在多台设备间互相同步。两点提醒传输是明文只放在可信局域网里用首次同步前先把列表备份一次同步出问题时能回滚。连通性检查很简单手机浏览器打开http://PC地址:23332/hello能显示欢迎语就说明两端网络已互通。服务端实现见 src/main/modules/sync/。开放 API。在设置 → 开放 API里开启后软件会起一个 HTTP 服务默认只监听127.0.0.1:23330即只接受本机调用需要局域网访问再打开 bindLan 开关。对外暴露/status、/play、/pause、/skip-next、/skip-prev、/seek、/volume、/mute、/collect、/uncollect、/lyric、/lyric-all等端点/subscribe-player-status以 SSE 事件流持续推送播放状态默认推送歌名、歌手、专辑、当前歌词行、时长、进度、倍速等字段拿它做歌词桌宠、状态面板最方便。实现代码见 src/main/modules/openApi/。服务起来后本机一条命令验证curl http://127.0.0.1:23330/status返回当前播放状态的 JSON 就说明端点可用。自定义音源。给 LX Music 加新音源的方式是准备一个 JavaScript 脚本在设置里导入脚本声明支持的源与musicUrl动作运行时监听应用发来的请求被点名时返回该歌曲的 http/https 直链。脚本里可以直接用lx.request发 HTTP 请求不受跨域限制且跟随软件内的代理设置加解密方面自带 AES、MD5、RSA 等工具函数应付大多数音源接口的签名逻辑够了。运行时实现在 src/main/modules/userApi/。适合给某个平台配专属音源或在默认音源不稳定时留一条备用链路。LX Music 数据存在哪里配置、列表、下载缓存都落在平台固定的数据目录里Windows%APPDATA%/lx-music-desktopLinux~/.config/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktop例外Windows 版v1.17.0 及以上程序目录下有portable文件夹时数据直接写进该文件夹给新手的三句落地建议第一次用选 Windows 安装版更新提示是现成的出问题基本都卡在接口源上按换源 → 换网 → 改 DNS的顺序排查别跳步想深挖就先把开放 API 开起来自定义音源和桌面歌词都建立在这套本地服务之上。版本变化可查 CHANGELOG.md。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考