ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Folia:让每首歌都变成文字PV的开源全屏歌词动画播放器

Folia:让每首歌都变成文字PV的开源全屏歌词动画播放器

Folia:让每首歌都变成文字PV的开源全屏歌词动画播放器

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

歌词不该只是角落里滚动的白字,这是 Folia 的前提。它是一款开源的全屏歌词动画播放器,围绕“辞曲新境”这个口号来做:在线音源覆盖网易云、酷狗、QQ 音乐和 Navidrome(自建音乐服务器软件),桌面版还支持波点音乐、YouTube Music、Spotify 与本地音乐库,桌面端与 Web 端都能跑。

它凭什么值得你切过来

  • 全屏歌词动画:整个屏幕就是舞台,十几种动画主题可选
  • 多音源自动回退:某个音源不可用,自动切到下一个
  • 本地库开箱即用:导入一个文件夹,歌词封面自动识别
  • AI 主题生成:按歌曲情绪生成专属背景与配色
  • 键盘优先:命令面板加全套快捷键,几乎不用碰鼠标

把歌放起来:安装与首次播放

桌面版基于 Electron(用 Web 技术打包桌面应用的框架)构建,内置前后端运行环境,即装即跑:

  1. Windows 与 macOS 直接下载安装包,Apple Silicon 有专属版本;Linux 提供.deb/.rpm,Arch 用户走 AUR(Arch 社区软件源)安装folia-major-bin,其他发行版解压tar.gz直接运行。
  2. 首次启动有欢迎引导,花半分钟扫一眼即可。
  3. 在首页搜索歌名、歌手或专辑,点搜索结果就开始播放,封面与歌词自动加载。
  4. 点播放区的+把歌加进队列;在任何歌曲列表里直接敲键盘,就能即时过滤当前内容。

首页的在线音源界面:

让歌词占满整块屏幕:全屏歌词动画

这是 Folia 的核心。播放歌曲后按H,播放控件全部退场,屏幕上只剩歌词动画;再按一次让它回来。再按F11让窗口铺满,歌词就以文字 PV 的形态占满整块屏幕——所有动画都是响应式布局,自动适配窗口尺寸,不需要额外设置。

全屏状态下,常用操作都收在几个键里:

快捷键功能
Space播放 / 暂停
←/→快退 / 快进 5 秒
Ctrl + →/Ctrl + ←下一首 / 上一首
S打开命令面板(万能入口)
Ctrl + P打开播放队列
P展开右侧面板(切换在线 / 内嵌 / 本地歌词)
H隐藏播放控件,只剩歌词
F11全屏

想换动画风格,走设置 → 视觉挑主题;拿不定主意就去主题公园(Theme Park)逛一圈——那里能把每个主题的真实动画跑起来,一边试听一边对比,比翻截图直观得多。

沉浸式全屏歌词动画与歌曲卡片:

每种主题各有一副性格:挑你的歌词动画风格

除默认主题外,内置了一整套风格迥异的动画:

  • 浮名 / 流光:经典逐字流光形态,歌词像光一样从暗场里浮出
  • 群唱(Cappella):歌词做成群聊对话,带头像表情,适合合唱说唱
  • 镜台(Diorama):3D 镜台场景,歌词悬浮在立体空间里
  • 时计(Pendolo):时钟机械风,齿轮与摆锤驱动的歌词演出

倾诉(Tilt)、心象(Cad)、云阶(Pat)、凝彩(Tempera)、绘光(Lumiere)、商籁(Sonnet)等,风格从拼贴排版到舞台光束各不相同。每个主题都有自己的调参面板与默认背景层,动画节奏、字幕显示、背景风格可以分开搭配,怎么调都顺手。

逐字发光的歌词特效,浮名主题:

群唱主题把歌词做成聊天对话气泡:

进阶玩法:AI 主题、本地曲库与模组系统

本地音乐库

进首页的本地音乐区域,点导入文件夹,选一个目录,等后台扫描完,专辑封面和内嵌歌词就都读出来了,全程不上传音频内容。

支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC 格式;同目录的.lrc、.vtt、.ttml、.qrc、.yrc、.krc歌词文件自动识别,也兼容 LDDC 生成的增强型逐字歌词。

缺失的歌词与封面由网易云、QQ、酷狗在线音源自动补全,按这个顺序回退;匹配不准可以手动改。目录里放.foliaignore能像.gitignore一样排除文件,目录下的cover.jpg可作整夹封面。完整规则(重扫、实体整理、故障排查)见本地音乐库管理。

本地音乐库界面:

AI 主题生成

接入 AI(Google Gemini 或 DeepSeek 等 OpenAI 兼容接口),它会按当前歌曲的情绪与歌词内容,直接产出这首歌的专属背景与配色;结果存进主题库复用,下次不用再等生成。

Folium 模组系统

桌面版带一个实验性模组系统:在设置 → 模组 → 模组系统里开启后,可以安装第三方模组,添加新的歌词动画、背景类型、播放页图层和命令。仓库mods/目录里有示范模组,覆盖歌词动画、调参、进度条与透明视频导出。

示范模组:极光视觉器效果预览:

给开发者:构建、部署与二次开发

想从源码跑起来,需要 Node.js ≥ 24:

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

Web 版支持一键部署到 Vercel 或 Cloudflare,部署后可安装为 PWA,手机上也能用。想全栈自托管(含网易云、酷狗、QQ 音乐的 API 服务),deploy/docker/目录提供了 Docker Compose 配置。

多设备用户可自托管官方sync-server,跨设备同步外观设置与 AI 主题库;部署完成后在设置 → 连接与集成里填服务端地址与SYNC_TOKEN即可。环境变量、Stage API、桌面端细节写在技术与开发说明里。

想写模组的话,从模组开发指南起步,npm run folium:new my-first-mod一条命令生成新模组骨架。

回到开头那个场景:装好 Folia、放一首歌、按一下H,你的屏幕上就已经在播一段文字 PV 了。下一步,去主题公园挑个合眼缘的风格,或者接上 AI 给这首歌生成一套专属主题,让歌词真正当回主角。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进