Folia 顶栏歌词lia.lines 插件接入 omarchy 4 桌面【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major用 lia.lines 插件你可以在 omarchy 4 / QuickShell 桌面的顶栏直接看到 Folia 正在播放的歌词还能就地暂停、继续播放不用切回播放器窗口。本地音乐、Navidrome 和在线音源都适用装完即生效。装完后长这样Folia 播到哪一行顶栏就滚到哪一行。播放状态在顶栏同步变化暂停/播放可以直接在顶栏点掉。还有一个兜底行为Folia 没在播放时lia.lines 会降级成一个简易 MPRIS 媒体信息组件显示当前元信息顶栏不会留出一块空白。三步把歌词挂上顶栏整个过程不用写一行代码。三步Folia 里开接口、装插件、顶栏启用。1. 在 Folia 里打开歌词接口路径设置 → 连接与集成 → 歌词接口 → 启用歌词接口。也可以直接在命令面板执行歌词接口命令快速切换。开关会持久化Folia 下次启动时自动监听固定端口 32109。2. 装 lia.lines 插件omarchy 用户去官方插件市场搜lia.folia-lyrics一键安装。其他 QuickShell 环境按插件仓库说明手动部署即可。3. 顶栏里启用在 QuickShell 的插件配置中打开 lia.lines。之后播放状态和歌词文本会跟着 Folia 自动更新无需额外配置。接口在背后怎么运转lia.lines 连的是 Folia 桌面端内置的本机歌词接口GET http://127.0.0.1:32109/v1/lyric。它是无鉴权的只读 HTTP API服务只监听 127.0.0.1 回环地址所以局域网和其他机器都访问不到安全性上不用操心。返回的 JSON 包含offset、lines、wordByWord、title、artist歌词行里带逐字时间轴和可选的翻译、罗马音。完整字段说明见 docs/lyric-api.md。接口实现见 electron/lyricApi.cjs它把 Folia 内部渲染用的歌词对象做了脱敏只输出稳定的公开字段插件不依赖内部实现细节。接口只在切歌、歌词加载完成、来源变化或你调整偏移时更新不随播放进度变。需要感知切歌的客户端按 500–1000 ms 低频轮询即可。前端的状态同步逻辑见 src/hooks/useLyricApiPublisher.ts。顶栏不显示歌词怎么办顶栏一直没有歌词先确认 Folia 里已启用接口再确认当前歌曲有可用歌词。设置页提示接口不可用说明 32109 端口被别的程序占了释放端口后重新启用。显示 null 或空白正常现象。没在播放、歌词加载中、歌曲本身没歌词时接口都返回null客户端需要能处理200 OK 加 JSON null这种情况。歌词对不上人声offset字段带着你手动设置的偏移单位毫秒客户端按 播放时间秒− offset/1000 对齐时间轴即可校正。适合谁下一步做什么如果你在 omarchy 4 或 QuickShell 桌面上用 Folia 听本地、Navidrome 或在线音乐这套组合值得配上顶栏常驻一行歌词不抢窗口焦点。现在就去设置页打开歌词接口开关顶栏马上就有变化。相关文档docs/lyric-api.md接口字段、响应示例与调用方式electron/lyricApi.cjs接口实现与数据脱敏逻辑src/hooks/useLyricApiPublisher.ts前端接口状态同步【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考