企业官网建设流程全解析

Folia 音乐播放器快速上手：5 分钟从找歌到全屏歌词动画

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

在 Folia 里听歌，你一定会忍不住按全屏：这款音乐播放器最大的特色，就是全屏歌词动画，整块屏幕就是一支文字 PV。网易云、QQ 音乐、酷狗都能在线播放，本地音频也能导入成自己的本地音乐库。这篇文章写给刚安装的新手，读完你能自己扫码登录、导入本地歌曲，并换出喜欢的歌词动画。

主界面长什么样

打开应用，你看到的不是一首歌一行的列表，而是一组悬浮在画面中央的 3D 卡片，每张卡片就是一个音乐入口：

• 在线平台卡片：网易云、QQ 音乐、酷狗，点进去直接搜索；
• 本地库卡片：导入音频文件夹后，专辑卡、歌手卡会出现在这里；
• Navidrome 卡片：Navidrome（Navidrome，自建的音乐流媒体服务器）接入后，浏览和播放跟在线平台一样。

点卡片进入下一级，返回逐级往回退，走得很深也不怕迷路。

💡 主界面顶部是窗口拖拽区；播放开始后标题栏会自动收起，把画面完整让给歌词。

歌从哪来

三条路，都能把歌放进播放器。

在线平台扫码登录

1. 打开统一面板（UnifiedPanel）的账号页签，选择平台（网易云 / QQ / 酷狗）；
2. 手机扫二维码，登录完成，主网格里就出现对应平台卡片。

本地音乐库导入

1. 在本地库页签点“Import Folder”，选中音乐文件夹；
2. 扫描完成后，专辑和歌手卡片随之更新；
3. 重扫、在线歌词和封面匹配也都在这个页签里做，完整流程见 docs/local-library-management.md。

Navidrome 接入

在设置的“集成”组填服务器地址和账号，保存后主界面出现 Navi 卡片，歌单、专辑、歌曲都能像在线平台一样翻。

播放怎么控

屏幕右下角的统一面板是高频操作区，分成五个页签：

每个页签都是 src/components/panelTab/ 目录下的独立组件，控制页是 ControlsTab，队列页是 QueueTab，账号页是 AccountTab。

调成自己的样子

点面板里的 ⚙️ 打开设置弹窗，新手常用的是四组：

• 通用：语言、明暗风格、开机行为；
• 外观：主题模式、自定义主题、Theme Park（主题乐园，预设主题画廊）；
• 播放：预加载、回放增益（ReplayGain，让每首歌响度一致）、音频输出设备；
• 桌面端：窗口圆角、透明度、点击穿透、防息屏。

其余的集成、存储、实验组面向进阶需求，用到再进。

高光时刻：全屏歌词动画

按下全屏键，主界面让位给歌词——这才是 Folia 最出圈的部分。先试这几种：

• Fume：文字像烟雾般缓缓铺开，当前句浮在最前，其余句子淡进背景；
• Lumiere（绘光）：一道光束逐字点亮歌词，像追光扫过舞台；
• Cappella：歌词变成群唱对话，一行行歌词装在聊天气泡里依次落下。

此外还有 Monet、Sonnet、still 等十一种风格，全部注册在 src/components/visualizer/registry.tsx，每种都有独立可调参数。

读完先做这三件事

1. 打开本地库页签，导入一个音频文件夹；
2. 登录任意一个在线平台，随便放一首歌；
3. 按全屏键，依次切换 Fume、Lumiere、Cappella，看歌词怎么动。

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