Folia 全屏歌词播放器上手教程：14 种歌词动画，10 分钟点亮整块屏幕

Folia 全屏歌词播放器上手教程：14 种歌词动画，10 分钟点亮整块屏幕

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

Folia 是一款支持网易云、QQ 音乐、酷狗、本地音乐库和 Navidrome 的歌词动画播放器，最大的卖点是把歌词变成全屏沉浸式文字 PV。这篇上手教程带你从开机走到第一首全屏歌词，全程不超过 10 分钟。

第一次打开，三步听到第一首歌

首页不是歌曲列表，而是一张悬浮的 3D 卡片网格，每张卡片对应一个音乐入口，可以点进去、逐级退回来。

1. 点首页的网易云卡片，进入该平台的搜索页；
2. 在搜索框输入歌名，点结果里的任意一首，播放立刻开始，封面和歌词会自动加载；
3. 在播放页进入全屏歌词模式，第一句歌词就会在你眼前动起来。

三步走完，你就站在 Folia 最核心的体验里了。整个导航由 src/hooks/useAppNavigation.ts 驱动，点卡片进去、再点回去，层级不会乱。

你的歌从哪儿来：四种入口一张表

本地库支持 MP3、FLAC、M4A 等 7 种格式，导入后首页会出现"导入文件夹"和"刷新"按钮。它还会自动给本地歌曲匹配在线歌词和封面，规则写得很细，想深挖可以翻 本地音乐库管理文档。

高频操作都在右下角面板，查这张表就够了

Folia 把高频操作收在屏幕右下角的统一面板里，顶部一排页签各管一摊，代码在 src/components/panelTab/ 目录：

设置分三档，新手只动前两档就够

面板里的齿轮图标打开设置弹窗（src/components/modal/SettingsModal.tsx），页签很多，但按使用频率分三档看就清楚了：

• 建议改：通用页的语言与明暗风格，外观页的主题模式——花 1 分钟改完，界面观感就定了；
• 可选：播放页的预加载、回放增益（ReplayGain，统一不同歌曲响度的技术）、音频输出设备——对声音敏感再动；
• 进阶：集成页的 Navidrome 与 OBS 源连接，存储页的缓存清理和多设备同步，桌面端的防息屏、点击穿透。

新手卡在第 1 档做完就可以关掉弹窗了，剩下的以后按需回来补。

14 种全屏歌词动画：Folia 出圈的主角

前面都是铺垫，Folia 真正让人停下来不走的，是它的歌词动画。内建 14 种模式：流光、绘光、浮名、群唱、倾诉、镜台、时计、莫奈、心象、云阶、商籁、回环、凝彩、静止，每种都有独立可调参数，全部注册在 src/components/visualizer/registry.tsx。风格差异肉眼可见：浮名把歌词做成缓缓升腾的字雾；群唱则用聊天气泡加虚拟角色，把整首歌排成一场对话：

不想纠结配色，可以让 AI 根据歌曲情绪和歌词内容自动生成主题，背景、字色、视觉参数一次配齐。切换模式也不用退出播放，画面会平滑过渡，切歌时歌词衔接不会跳帧。

三个容易被忽略的细节

• 本地歌词不止在线匹配：同目录同名的 .lrc、.vtt、.qrc、.krc 等 6 种格式会被自动识别，内嵌 LRC 的音频文件也能直接读。
• 标题栏会自己隐身：播放时顶部标题栏自动隐藏，双击它还能最大化窗口，全屏看歌词更干净。
• 同步服务端是可选的：多设备想同步外观设置和 AI 主题库，需要自己托管一个 sync-server，单机使用完全不依赖它。

从三步放歌到 14 种全屏歌词动画，Folia 的路径比想象中短——装好、点卡片、让歌词飞起来，剩下的慢慢玩 🎧

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