Folia 歌词接口实战32109 端口一个 GET 请求拿到带翻译的逐字歌词【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major想让悬浮窗跟着 Folia 的播放逐字变色还是把它的歌词数据同步进直播画面解析器不用自己写。Folia 的本机歌词接口就是一个开关加一个 GET 请求的事。两分钟接通从歌词接口开关到第一条歌词① 打开 Folia 桌面端Windows / macOS / Linux 均支持Web 版不提供进入设置 → 连接与集成 → 歌词接口打开启用歌词接口开关。习惯命令面板的话直接搜歌词接口命令更快。开关状态会持久化下次启动自动监听。② 启用成功后设置页会直接显示接口地址http://127.0.0.1:32109/v1/lyric可一键复制。③ 终端里发一个请求curl http://127.0.0.1:32109/v1/lyric看到 JSON 即成功返回null只是当前没加载歌词不是故障。接口参数一表打尽项目值监听地址127.0.0.1仅 IPv4 回环端口32109固定路径/v1/lyric方法GET另有OPTIONS预检鉴权无数据格式JSONUTF-8⚠️ 32109 被占用会导致启用失败设置页显示错误⚠️ 不要依赖 localhost直接写死 127.0.0.1。服务端实现看 electron/lyricApi.cjs前端状态同步在 src/hooks/useLyricApiPublisher.ts。歌词 API 响应字段拆解读懂那个 JSON顶层字段一览字段类型一句话说明offsetnumber用户手动设置的歌词偏移单位毫秒正延后负提前linesarray按时间排序的歌词行wordByWordbooleantrue数据源原生逐字时间falseFolia 按逐行时间合成title/artiststring?歌曲标题与艺术家为空时不返回每行lines[]内部text完整歌词文本startTime/endTime行时间单位是秒和 offset 的毫秒不是一回事words[]逐字时间轴每字含text/startTime/endTimetranslation/romanization可选的翻译与罗马音backgroundVocals[]可选的背景人声自带独立的逐字数组一个典型响应节选{ offset: -250, wordByWord: true, lines: [ { text: Hello world, startTime: 12.4, endTime: 15.1, words: [ { text: Hello, startTime: 12.4, endTime: 13.5 }, { text: world, startTime: 13.5, endTime: 15.1 } ], translation: 你好世界 } ] } 源歌词只有逐行时间普通 LRC时Folia 也会自动合成出words所以它几乎总有内容。但此时wordByWord为false那些逐字时间是估算值别当精确逐字时间用。避坑清单null、轮询与安全红线状态码含义200成功返回歌词对象或null204CORS 预检通过404路径不存在405方法不支持null 必须判空没歌、加载中、歌曲无歌词都是 null且仍是 200。轮询就定 500–1000 ms数据只在切歌、加载完成、调偏移时变化高频请求没有意义。当前行要自己算快照不含播放进度和行索引用播放时间(秒) - offset / 1000比对行时间。逐字时间看情况用wordByWord为 false 时是行时间估算敏感场景要降级处理。严禁暴露到外网无鉴权接口不要做端口转发或反代出去。另外接口已开Access-Control-Allow-Origin: *本机浏览器页面可以直接跨域 fetch这是 OBS 浏览器源方案能成立的前提。三个场景看它能帮你省多少事桌面歌词悬浮窗轮询接口按播放时间定位当前行在悬浮窗渲染逐字高亮。words[]让你直接做出卡拉OK式逐字变色不用自己估时间。OBS / 直播歌词源写一个本地 HTML 页面 fetch127.0.0.1:32109/v1/lyricFolia 的歌词动画数据就同步进直播画面跨域已放行。跨程序歌词同步外部歌词面板、校对工具直接复用这份归一化数据省掉自己解析 LRC/YRC 的全部麻烦。下一步完整字段定义、更多响应示例和版本兼容策略都在 docs/lyric-api.md想看服务端怎么写入口就是 electron/lyricApi.cjs。打开 Folia 设置curl 一下三秒钟看到歌词。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考