Folia 三步把当前歌词挂到桌面顶栏QuickShell 插件 lia.lines 与歌词接口实战【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款主打歌词动画效果的音乐播放器支持本地音乐、Navidrome 和多平台在线音源。这篇文章解决一个问题如何用 Folia 歌词接口配合官方插件 lia.lines把当前播放的歌词挂到 QuickShellomarchy 4桌面顶栏不用打开 Folia 窗口顺手还能在顶栏做暂停 / 播放控制。全程只需要在 Folia 里打开一个开关再装一个插件。先看成品顶栏常驻一行歌词接通之后顶栏会发生三件事歌词同步连接 Folia 的folia-v1-lyric歌词接口实时滚动当前歌词播放控制在顶栏直接暂停 / 播放降级展示Folia 没在播放时它退化成一个简易 MPRIS 组件把媒体信息留在顶栏不留空白第一步在 Folia 里启用歌词接口️ 打开 Folia 桌面端进入设置 → 连接与集成 → 歌词接口 → 启用歌词接口设置会持久化下次启动时 Folia 自动监听32109端口。如果端口被别的程序占了设置页会直接提示接口不可用释放端口后重新启用即可。也懒得翻设置的话命令面板里执行歌词接口命令就能切换前端的发布逻辑见 src/hooks/useLyricApiPublisher.ts。第二步从插件市场安装 lia.linesomarchy 用户在官方插件市场搜lia.folia-lyrics一键安装。其他 QuickShell 环境可以按插件仓库的说明手动部署。整个过程不用写一行代码 装完它就会出现在顶栏的插件列表里。插件的详细背景可以看 docs/technical.md 的 Quickshell 歌词插件 一节。第三步在顶栏打开插件并验证在 QuickShell / omarchy 的插件配置里启用 lia.lines顶栏就开始显示歌词。播放状态和歌词文本会跟着 Folia 自动刷新切歌后顶栏跟着换行。歌词接口不挑音源本地文件、Navidrome、在线曲库播什么都行顶栏都能抓到。接口返回 null 怎么处理顶栏冒出null先别慌这是正常响应不是故障现象处理办法顶栏不显示歌词确认 Folia 已启用歌词接口且当前歌曲有可用歌词设置页提示接口不可用32109端口被占用释放后重新启用显示null/ 空白没在播放、歌词还在加载、歌曲无歌词都会返回null歌词对不上口型顶层offset字段携带用户设置的偏移毫秒插件会自行校正还想感知切歌时序的话看这里接口只在切歌、歌词加载完成、用户调整偏移时更新不会跟着播放进度变。所以按500–1000 ms低频轮询、比较两次响应就够了没必要更高频。细节在 docs/lyric-api.md 的使用注意事项一节。folia-v1-lyric 接口到底返回什么 插件的核心依赖是 Folia 桌面端内置的一个只读 HTTP APIGET http://127.0.0.1:32109/v1/lyric有三个事实值得知道只听回环绑定127.0.0.1局域网和互联网都摸不到无需鉴权但也没有暴露风险字段经过脱敏electron/lyricApi.cjs 里的实现会把 Folia 内部歌词对象做脱敏只暴露逐字时间轴、翻译、offset这类稳定公开字段插件不会依赖内部渲染细节快照语义返回的是当前歌词快照不包含播放时间、当前行索引和播放状态顶栏这行字和 Folia 窗口里的全屏歌词动画互不抢戏一个管扫一眼一个管沉浸。歌词接口本身只读不带播放控制顶栏的暂停 / 播放由 lia.lines 插件自己完成如果之后想在外部对播放器做更深的联动可以再看 docs/technical.md 里的 Stage API 部分。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考