企业官网建设流程全解析

Folia 顶栏歌词完整指南：3 分钟把当前歌词挂上 omarchy 桌面

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一款主打绚丽歌词动画的播放器。如果你在用 omarchy 4 / QuickShell 桌面，跟着本文装好官方歌词插件 lia.lines，当前歌词就能常驻顶栏，还能直接暂停播放。

先说说这个烦恼

Folia 的歌词动画确实好看，但有个前提：窗口得在你眼前。

一旦切到别的软件，歌词就"隐身"了。想看一句得切回来，切一次就打断一次思路。顶栏歌词就是为了解决这件事：窗口在哪不重要，抬眼就有词。

做完之后你会得到什么

• 顶栏歌词跟播进度实时滚动，不用切窗口瞄歌词
• 顶栏可直接暂停 / 播放，手不用离开键盘
• Folia 没在播放时，自动变成简易 MPRIS 媒体信息组件，不占空位
• 数据源只监听本机回环地址，无需鉴权，局域网也访问不到

动手之前

对照下面的清单确认一遍，全程大约 3 分钟：

• 你装的是 Folia 桌面端（Electron 版本），网页版没有歌词接口
• 桌面是 omarchy 4 或其他 QuickShell 环境
• 准备一首有歌词的歌（无歌词的歌接口只会返回 null）
• 确认 32109 端口没有被其他程序占用

核心实操

任务卡 A：打开 Folia 的歌词接口

🎯 目标：让 Folia 把当前歌词数据暴露给本机插件

🔧 操作：

1. 打开 Folia 设置页，进入"连接与集成"里的"歌词接口"，启用接口
2. 不想翻设置的话，直接开命令面板搜索"歌词接口"，同样能切换

✅ 验证：启用后设置页显示接口正常监听；此后 Folia 每次启动会自动挂上这个接口。若提示接口不可用，多半是端口被占，释放后重新启用即可。

任务卡 B：装上 lia.lines 插件

🎯 目标：在顶栏配置里拿到能连 Folia 的歌词组件

🔧 操作：

1. omarchy 用户打开官方插件市场，搜索 lia.folia-lyrics，一键安装
2. 其他 QuickShell 环境按插件仓库的说明手动部署

✅ 验证：安装完成后，QuickShell 的插件列表里能看到 lia.lines 这个组件。

任务卡 C：顶栏启用并验证

🎯 目标：顶栏真的滚出歌词

🔧 操作：

1. 在 QuickShell 插件配置中启用 lia.lines
2. Folia 里播一首带歌词的歌，观察顶栏

✅ 验证：顶栏出现当前歌词并随播放滚动；再点一下暂停，顶栏状态跟着变。

到这里就齐了。接口实现逻辑在 electron/lyricApi.cjs，它只把稳定的公开字段交出去，插件不依赖 Folia 内部实现，后续升级也不易失效。

进阶玩法

💡 逐字级同步：接口返回的数据里带逐字时间轴和 offset 偏移字段（详见 docs/lyric-api.md），插件会自行按偏移校正。所以你在 Folia 歌词面板里手动调了歌词延迟，顶栏会跟着变准，不用两边重复调。

组合思路：本地歌、Navidrome、在线音源走的是同一套歌词管道，换音源时顶栏歌词不用改任何配置，跟着 Folia 的播放走就行。插件背景介绍可看 docs/technical.md 的 QuickShell 歌词插件一节。

避坑速查

下次放歌，抬头就有词，Folia 窗口在不在前台都不重要了。

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major