把五个音源装进本地曲库：LX Music 从安装包到开放 API 的完整指南

把五个音源装进本地曲库LX Music 从安装包到开放 API 的完整指南【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktopLX Music 是一款 Apache 2.0 协议的开源音乐播放器基于 Electron 与 Vue 3 构建。它把酷我、酷狗、QQ 音乐、网易云、咪咕五个音源收进同一个搜索框试听音质最高到flac24bit也支持批量下载并内嵌封面与歌词。本文按装起来 → 存歌 → 调体验 → 接设备 → 排故障的路线带你从零跑通它。 该装哪个安装包Windows 分安装版Setup和绿色版green两类带x64/x86字样对应系统位数。两者的差别只有一条只有安装版支持启动时检测新版本并弹窗提示更新绿色版需要你自己换包。macOS 选.dmg文件Linux 提供.deb、.rpm、.AppImage、.pacman四种格式按你的包管理器挑一个。绿色版从 v1.17.0 起支持便携模式只要程序文件夹里存在portable文件夹配置和列表就直接写进这个文件夹整个目录拷到 U 盘就能带走。装完启动主界面四块区域左侧导航、顶部搜索框、中部歌曲列表、底部播放控制栏。 搜到的歌怎么变成本地曲库搜按F1聚焦顶部搜索框输入歌名回车。五个音源的结果合并返回不用先选平台每条结果旁标着当前可用的档位128k、320k、flac、flac24bit具体哪档能用取决于平台和曲目。听点任意一条结果直接播放这首歌会自动加入我的列表的试听列表之后随时能翻到不用重新搜。想一次放多首用Ctrl点选或Shift连选后添加到列表即可。存批量下载默认关闭第一次用先去设置 → 下载打开开关。选好后右键下载任务进下载页面统一管理能补下失败项也能把歌加回列表。下载默认保存在桌面常用默认值如下设置项默认值什么时候需要改文件命名歌名 - 歌手想在文件名里带专辑或序号时并发任务数3网络稳定想加快批量速度时同名文件跳过已存在想覆盖旧文件时才调整封面嵌入开启想减小文件体积时关闭歌词嵌入lxlrc 默认嵌入普通 lrc 需手动勾选其他播放器要读.lrc内容时按列表名分目录关闭想按歌单整理曲库时命名加跳过重复是最省心的组合同名文件不会互相覆盖重下也不会产生混乱。 音质、主题和桌面歌词怎么调音质在设置 → 播放里选。默认128k日常够听还省流量网络条件好再调高。出错自动跳过默认开启某首歌加载失败时直接切下一首不用手动处理。主题默认是绿色内置主题一键切换其中水墨、月夜两套比较出挑设置里也能自建主题拖一张背景图配上主色即可。桌面歌词默认关闭在设置 → 桌面歌词开启后它是一个独立小窗默认尺寸450×300。可调项横排或竖排、字号、已播与未播歌词颜色、窗口透明度窗口支持锁定位置和始终置顶。主窗口全屏或歌曲暂停时它默认自动隐藏不挡屏幕。快捷键分应用内和全局两套在设置 → 快捷键管理。应用内默认启用全局默认关闭按键作用生效范围CtrlF5播放 / 暂停应用内Ctrl←/Ctrl→上一曲 / 下一曲应用内CtrlAltF5播放 / 暂停全局CtrlAlt←/→上一曲 / 下一曲全局CtrlAlt↑/↓音量加 / 减全局CtrlAlt0桌面歌词显隐全局macOS 上Ctrl对应Cmd。建议至少打开全局的播放/暂停和桌面歌词显隐两项切窗口后还能顺手控制。 开放 API、数据同步和自定义音源什么时候开这三项都在设置里默认全部未启用用哪个开哪个。数据同步在设置 → 数据同步开启后PC 端启动本地服务默认端口23332手机端填上 PC 的局域网地址歌单、列表、设置就能在多台设备间互相同步。传输是明文只在可信局域网里用首次同步前先把列表备份一次出问题还能回滚。开放 API在设置 → 开放 API开启后本机起一个 HTTP 服务默认只监听127.0.0.1:23330即只接受本机调用。对外暴露/status、/play、/pause、/skip-next、/lyric、/volume、/seek、/collect等端点其中/subscribe-player-status以 SSE 事件流持续推送播放状态做歌词桌宠、状态面板这类小工具最方便。服务起来没有一条命令验证curl http://127.0.0.1:23330/status返回当前播放状态的 JSON 说明端点可用。实现可以看 src/main/modules/openApi/。自定义音源在设置 → 音乐来源导入一个 JavaScript 脚本。脚本声明它支持的源和musicUrl动作被调用时返回该歌曲的直链脚本里可以直接用lx.request发请求不受跨域限制且跟随软件内的代理设置加解密自带 AES、MD5、RSA 工具函数够应付大多数音源的签名逻辑。运行时实现在 src/main/modules/userApi/。适合给某个平台加专属音源或在默认音源不稳定时留一条备用链路。 搜索不工作或界面空白怎么排查现象搜索整页刷不出来所有歌曲提示请求异常。原因当前接口源不可用或本机 DNS 到不了接口服务器。解法先去设置 → 音乐来源换一个接口源再连手机热点验证是不是网络问题都不行就把 DNS 改成223.6.6.6或8.8.8.8改完重启软件。按这个顺序排别跳步。现象Windows 10/11 上界面整屏空白或窗口显示不全。原因GPU 沙箱与显卡驱动冲突属于渲染层问题。解法给快捷方式加启动参数--disable-gpu-sandbox没效果再逐个换成--no-sandbox、-dha、--disable-gpu恢复显示的那个就是你要的参数。现象下载任务报错ENOENT: no such file or directory, mkdir。原因所选下载目录没有读写权限软件连建文件夹都做不到。解法把下载目录换成有权限的路径比如用户主目录下自己新建的文件夹。数据目录速查与落地建议配置、列表、下载缓存都存在平台固定的数据目录里Windows%APPDATA%/lx-music-desktopLinux~/.config/lx-music-desktopmacOS~/Library/Application Support/lx-music-desktop例外绿色版v1.17.0 及以上程序目录下有portable文件夹时数据直接写进该文件夹给你的三条建议新手直接装 Windows 安装版Setup因为更新提示是现成的绿色版每次都要自己换包日常遇到问题按换源 → 换网 → 改 DNS的顺序排一遍别跳步日常故障基本都卡在接口源上想往深挖先开一个开放 API 玩起来自定义音源和桌面歌词都建立在这套本地服务之上先跑通/status再扩展。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考