企业官网建设流程全解析

Folia 快速上手教程：5 分钟让歌词在整块屏幕上"动起来"

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

Folia 是一款以全屏歌词动画为核心的开源播放器：在线音源、自建 Navidrome 与本地文件夹，最终都汇入同一个歌词舞台。本教程带你在桌面版与本地曲库之间走一遍完整流程，约 5 分钟，整块屏幕就会被一首"会动的歌"接管。

为什么选 Folia：歌词接管整块屏幕

普通播放器把歌词当作角落里的附属品，Folia 则把歌词当作舞台本身——项目称之为"辞曲新境（Lyrics Reimagined）"。歌从哪里来并不重要，重要的是它最终都以全屏歌词动画的形式呈现。

Folia 安装指南：三种方式各取所需

多数人直接选桌面版即可——安装包内置前后端运行环境，打开即用，不需要再配置任何服务。

💡 首次启动会看到功能引导，花 30 秒翻完即可，之后不会再打扰你。

第一首歌只需 30 秒：从搜索到出声

只要会打字，第一首歌立刻就能响。

1. 在首页搜索框输入歌名或歌手名，支持拼音联想，结果实时刷新；
2. 点击任意一条结果，播放立即开始，封面与歌词自动加载；
3. 想连播时，在播放控制区按+把歌曲加入队列。

💡 在多数列表页直接敲键盘就能触发搜索，不必先点进搜索框；某个音源暂不可用时，Folia 会自动回退到下一个可用来源，不用改任何配置。

三个键让播放器退场，只留歌词在屏幕上

这是 Folia 的核心体验：一个键下去，播放器"退场"，屏幕上只剩歌词动画。

1. 播放页按H：播放控件淡出，画面只剩歌词舞台；
2. 按F11：窗口铺满屏幕，动画自适应新的尺寸；
3. 按S打开命令面板，搜"主题公园"（或直接按快捷键T）：在这里逐一试听全部主题，动画节奏、字幕样式、背景风格都能逐项微调。

💡 每个主题都带独立参数面板，进全屏后可以边听边逐项调参，慢慢调出只属于你的版本。

十几种歌词"舞台"：找到你偏爱的那副面孔

同一份歌词，换一种动画就是另一种听感。

其余主题在主题公园里逐一试听即可。不同主题的排版氛围各不相同，且都能自动适配窗口尺寸。

Folia 快捷键速查：高频按键都在这里

Folia 本地音乐导入：四步搭好你自己的曲库

导入一次，整个文件夹就是你的曲库。

1. 到首页本地音乐（Folder）区域；
2. 点击导入文件夹，选择你的音乐目录（支持递归扫描，兼容 MP3 / FLAC / M4A / WAV / OGG / Opus / AAC）；
3. 后台自动读取元数据、专辑封面、内嵌歌词与同目录歌词文件；
4. 缺失的歌词和封面由在线音源按网易云、QQ 音乐、酷狗的顺序自动补齐，匹配不准可以手动改选候选。

💡 不想进库的文件可以在音乐目录里写.foliaignore排除（语法与.gitignore相同），它只影响索引，不会动磁盘上的任何文件。

歌单导入、增量重扫、艺术家与专辑实体编辑等细节见本地音乐库管理文档。

Folia 源码运行：clone 之后三条命令开跑

想从源码折腾的话，只需要 Node.js 24 及以上：

git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major npm install npm run dev

• Web 版：在线播放需要填写网易云 API 实例地址（VITE_NETEASE_API_BASE），完整环境变量清单见技术与开发说明；桌面版则内置 API，什么都不用填。
• Docker 自托管：下载compose.yaml与.env模板后执行docker compose pull && docker compose up -d，Web 版在:18080打开，细节见 deploy/docker。

跑起来之后：值得再试的三件事

1. AI 主题生成：进主题公园，让 AI 按当前歌曲的歌词与情绪生成专属背景与配色（Web 版需先配置 AI API 密钥）；
2. 跨设备同步：部署 sync-server（Cloudflare Workers / Docker / Node.js 均可），在"设置 → 连接与集成"填入服务端地址与SYNC_TOKEN，外观设置和 AI 主题库就能在手机与电脑之间同步；
3. Folium 模组：桌面版在"设置 → 模组 → 模组系统"开启后，安装官方签名模组即可添加新歌词动画与按钮，示范模组见 mods/ 目录。

Folia 让"听歌"从耳畔的事，变成整块屏幕的事。

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