Folia 歌词接口：一个 GET 拿到当前歌曲的逐字歌词

Folia 歌词接口一个 GET 拿到当前歌曲的逐字歌词【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major接上它能得到什么逐字时间轴而不只是一句歌词文本Folia 里正播着一首歌你的程序也能拿到它的逐字时间轴、翻译和背景人声一个 GET 请求http://127.0.0.1:32109/v1/lyric返回的就是当前歌曲完整的逐字歌词快照。歌词接口是 Folia 内置的本机 HTTP 服务不申请 token、不注册账号仅限本机生效。从接通到拿到第一条响应比你想的短。30 秒上手启用歌词接口立刻拿到响应只需两步。第一步打开 Folia 桌面端设置 → 连接与集成 → 歌词接口拨亮启用歌词接口开关启用后设置页直接显示接口地址一键复制即可也可在命令面板执行歌词接口命令快速切换。第二步在本机终端发一个请求curl http://127.0.0.1:32109/v1/lyric返回 JSON 对象或null就说明接通了。设置会持久化下次启动自动监听该接口仅桌面端提供Web 版没有。Python 侧一行搞定import requests lyrics requests.get(http://127.0.0.1:32109/v1/lyric, timeout2).json()地址有了再看响应里装着什么。关键信息速览歌词接口的监听地址与请求方式项目值监听地址127.0.0.1仅 IPv4 回环固定端口32109接口路径/v1/lyric请求方法GET另有OPTIONS预检鉴权无数据格式JSONUTF-8⚠️ 服务只监听127.0.0.1局域网和其他设备访问不了客户端写死这个地址别依赖localhost的 IPv4/IPv6 解析结果。若32109被别的程序占用启用会失败设置页会显示对应错误释放端口后关闭再重新启用即可恢复。请求侧该记的都在这张表里了把响应体拆开看。响应字段明细offset 是毫秒lines 是秒别混字段类型说明offsetnumber用户手动歌词偏移单位毫秒正延后、负提前未调整为 0linesarray按时间排序的歌词行lines[].textstring该行完整文本lines[].startTime/endTimenumber行起止时间单位秒lines[].words[]array逐字时间轴每项含text/startTime/endTime秒lines[].translation/romanizationstring?翻译与罗马音有内容才返回lines[].backgroundVocals[]array?背景人声自带独立逐字数组wordByWordbooleantrue数据源原生逐字时间falseFolia 按行时间合成title/artiststring?标题与艺术家为空不返回{ offset: -250, wordByWord: true, title: Example Song, lines: [{ text: Hello world, startTime: 12.4, endTime: 15.1, words: [{ text: Hello, startTime: 12.4, endTime: 13.5 }] }] }即使原始歌词是只有逐行时间的普通 LRCwords也几乎总有内容——但此时wordByWord为false说明逐字时间是估算值别把它当精确的逐字对齐依据。单位理清了该聊接入时会踩的坑了。歌词接口避坑清单从 null 到暴露处理null没在放歌、歌词加载中、该歌无歌词都是200 OKnull属正常状态分支必须写轮询策略数据只在切歌、歌词加载完成、调整偏移时更新不随播放进度变化。感知切歌就每 500–1000 ms 请求一次并比较内容自己算当前行接口不含播放进度和当前行索引用播放时间(秒) - offset / 1000与行时间比对安全红线无鉴权的本地接口绝不通过端口转发或反向代理暴露到外网。状态码含义200成功返回歌词对象或null204CORS 预检通过404路径不存在405方法不支持接口未启用或 Folia 未运行时是连接失败收不到任何 HTTP 状态码。 已开启Access-Control-Allow-Origin: *本机浏览器页面自制 HTML 歌词页、OBS 浏览器源可直接跨域 fetch。坑清完了看三个现成的玩法。三种玩法每种一句话思路就够桌面歌词悬浮窗轮询 → 按时间定位当前行 → 悬浮窗渲染逐字高亮words[]直接换来卡拉 OK 式逐字变色OBS 直播歌词源本地 HTML 页面 fetch 这个地址Folia 的歌词动画数据就进了直播画面省掉自建解析链路歌词校对与同步工具复用这份已归一化的逐字结构LRC/YRC 解析器一个字都不用写多音源对齐的麻烦也一并省掉。收尾Folia 把歌词数据合同压成固定端口32109 单一路径 零鉴权接入的全部代价就是一个开关加一个 GET。完整字段定义、响应示例与版本兼容策略在官方文档 docs/lyric-api.md服务端实现在 electron/lyricApi.cjs前端状态同步逻辑见 src/hooks/useLyricApiPublisher.ts。现在就去设置里拨亮开关你的第一条 curl 已经准备好了。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考