企业官网建设流程全解析

Folia 歌词动画播放器：从安装到全屏歌词的完整上手指南

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

Folia 是一个开源音乐播放器，把歌词当成界面的主角：在线音源、本地文件夹、自建 Navidrome 曲库里的歌，最后都会落到同一个全屏歌词舞台上。适合想快速搭建"能听、能看、能调"的音乐播放环境的用户。跟着本文操作，你可以完成下载安装、播第一首歌、进入沉浸式歌词画面，并把手本地曲库接进来。

它和常规播放器差在哪

三个点决定了 Folia 的定位：

• 音源可回退：支持网易云、酷狗、QQ 音乐、Navidrome 在线播放，桌面端还支持波点音乐、YouTube Music、Spotify、汽水音乐。某个音源连不上时会自动换到下一个可用来源，不用手动改配置。
• 本地曲库不上云：导入文件夹后只在本地保存索引，不上传音频文件；缺失的歌词和封面会按网易云、QQ、酷狗的顺序从在线音源自动补齐，匹配不准可以手动改选候选。
• 歌词动画可换可调：内置十几种排版风格各异的动画主题，每个主题带独立参数面板，动画节奏、字幕样式、背景风格都能逐项微调。

此外还有两项可选能力：按歌曲情绪与歌词内容用 AI 生成专属配色背景；桌面版可通过 Folium 模组加装新动画和按钮（实验性，默认关闭）。

下载并运行 Folia

装好桌面版后打开即可用，安装包内置了前后端运行环境，不需要额外配置服务。

1. 到项目 Releases 页面下载最新版。Windows、macOS 直接选对应平台的安装包（Apple Silicon 有专属版本）；
2. Linux 按发行版选包：Debian/Ubuntu 用.deb，Fedora 用.rpm，Arch 可在 AUR 安装folia-major-bin，其他发行版解压tar.gz后运行；
3. 双击启动。首次进入会显示功能引导，看完即可开始使用。

提示：如果下载速度慢，README 中列有国内网盘链接（夸克网盘、百度云，仅 Windows 与 Apple Silicon 正式版）。想跑在浏览器或手机上，可走 Web 部署路线，见下文"部署 Web 版"。

第一次搜索播放

首页搜索框输入歌名或歌手名，支持拼音联想，结果会实时刷新。

1. 在搜索框输入关键词，回车或等结果刷新；
2. 点击任意一首结果，播放立即开始，封面与歌词自动加载。完成后播放页应同时出现封面图与滚动歌词；
3. 想连播时，用播放控制区的+把其他歌曲加入队列即可。

提示：在多数列表页直接敲键盘就能触发搜索，不必先点进搜索框。若某首歌没出声，多半是该音源暂时不可用，等它回退到下一个来源，或换一首重试。

进入沉浸式歌词画面

播放中按一个键，播放控件就会退场，屏幕上只剩歌词动画——这是 Folia 的核心体验。

1. 在播放页按H，播放控件淡出，画面只留歌词舞台；
2. 再按F11让窗口铺满屏幕，动画会自适应新尺寸；
3. 随时按P唤出右侧面板，切换歌词来源（在线 / 内嵌 / 本地），按Tab在已打开的面板选项卡之间切换。

想换一种动画风格，去**主题公园（Theme Park）**逐个试听对比。比如群唱把歌词做成群聊对话气泡，镜台是 3D 旋转舞台，时计像咬合的齿轮机械，云阶像沿台阶上升的字幕。

常用操作速查

进阶与部署

以下三件事都不着急，但都是 Folia 用久之后的高频需求。

接入本地曲库

导入一次后，整个文件夹就持续作为曲库存在，新文件靠"重新导入"增量同步。

1. 到首页的本地音乐（Folder）区域，点击Import Folder（导入文件夹），选择音乐目录；
2. 等待后台扫描完成。此时会读取元数据、专辑封面与内嵌歌词，并识别同目录同名的.lrc、.ttml、.krc等歌词文件（支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC 格式）；
3. 缺失的歌词与封面由在线音源按网易云、QQ、酷狗的顺序自动补齐；匹配不准时，可以手动选择候选，或恢复首次导入的本地信息。

提示：本地库还支持.foliaignore排除不想要的目录和文件、歌单导入与艺术家/专辑实体编辑，细节见仓库内的 本地音乐库管理文档。

从源码运行

Web 版开发环境只需 Node.js 24 及以上，装完依赖即可在浏览器打开：

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

运行后按终端提示的地址打开页面，看到首页即表示开发环境就绪。

部署 Web 版与跨设备同步

• Docker 全栈自托管：deploy/docker 目录提供 Compose 完整栈（网关 + Web API + 在线音乐接口 + Sync Server），对外只发布两个端口，详见 deploy/docker/README.md；
• PWA 移动端：部署好 Web 版后，在手机 Chrome 或 iOS Safari 中把页面"添加到主屏幕"，即可当应用使用；
• 官方 sync-server：可选的同步服务端，用于在多台设备间同步外观设置与 AI 主题库。部署完成后在"设置 → 连接与集成"填入服务端地址和SYNC_TOKEN即可启用，支持 Cloudflare Workers、Docker 和 Node.js 自托管三种方式，源码与脚本在 sync-server/ 目录。

接下来可以做的三件事

1. 挑一首刚播完的歌，让 AI 主题生成为它定制一套配色背景；
2. 桌面版用户到"设置 → 模组 → 模组系统"开启 Folium 模组，装一个官方签名模组试试新动画；
3. 有多台设备的话，部署一次 sync-server，把主题库跨设备同步起来。

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