chthollyphile/folia-major 源码：https://github.com/chthollyphile/folia-major # Folia Lyrics Reimagined // 辞曲新境 GitHub 发布 (https://github.com/chthollyphile/folia-major/releases) 许可证 (https://github.com/chthollyphile/folia-major/blob/main/LICENSE) GitHub 星标 (https://github.com/chthollyphile/folia-major/stargazers) Node.js (https://nodejs.org/) 所有贡献者 桌面版下载 (https://github.com/chthollyphile/folia-major/releases) · Vercel 部署 (https://vercel.com/new/clone?repository-url=https://github.com/chthollyphile/folia-major) · 使用指南 (https://folia-site.vercel.app/guide/) · 技术说明

项目简介

Folia 是一个以全屏沉浸式歌词播放为核心的在线音乐播放器，支持网易云、Navidrome 和本地音乐库，通过智能歌词匹配、AI 生成配色主题以及多种全屏歌词动画，为用户提供独特的听歌体验。

如果你希望开箱即用、马上体验，推荐直接使用基于 Electron 的 Windows / macOS / Linux 桌面端版本。

如果希望在移动设备上使用，或在浏览器中体验云端多平台，可以选择一键部署到 Vercel (https://folia-site.vercel.app/guide/deploy-vercel) 的 Web 版本，或自行部署到其他支持 Node.js 的平台。

展示

演示视频

https://github.com/user-attachments/assets/fd27f4f0-64b9-4c57-8c3b-10df767f934b https://github.com/user-attachments/assets/704f195a-2194-434b-86e8-8f36290e5cc4

主题预览

浮名 流光 心象 云阶 群唱 倾诉

不同的歌词动画具有不同的排版氛围和可调参数，让全屏歌词拥有如同文字 PV 般的丰富视觉效果，同时又能兼顾响应式布局，自动适配不同窗口尺寸。

核心能力

桌面端下载

桌面版内置前后端运行环境，适合希望即装即用的用户。最新版本请前往 Releases 页面 (https://github.com/chthollyphile/folia-major/releases)。 Linux 包、Wayland / Hyprland 遥控窗和桌面端细节见 技术与开发说明。

文档与开发

更完整的使用说明请访问 Folia Guide (https://folia-site.vercel.app/guide/)。 部署、环境变量、本地开发、Stage API、常用脚本和技术栈见 技术与开发说明。 如果你希望快速上线 Web 版本，请阅读 Vercel 一键部署指南 (https://folia-site.vercel.app/guide/deploy-vercel) 来创建项目 Deploy with Vercel (https://vercel.com/new/clone?repository-url=https://github.com/chthollyphile/folia-major)

本地音乐与匹配说明

使用本地音乐时，Folia 会优先尝试从以下来源补全信息：

1. 音频文件自身元数据
2. 同目录同名歌词文件
3. 在线匹配结果

如果自动匹配不准确，可以在播放界面的右侧面板进入“本地”选项卡，手动搜索并指定更合适的歌词、封面或元数据来源。你也可以选择只使用本地信息，关闭在线匹配结果。

贡献者

感谢以下优秀人士。Issue 报告、Bug 报告、想法、文档、设计、测试和代码均通过 all-contributors (https://allcontributors.org/) 规范统计。

冬霧💻 zhao_alpha🐛 hz1ang🐛 🤔 steadyoak🐛 🤔 POINTER🐛 🤔 Yuki-3939🤔 MewsCat🐛 🤔 tumuyan🐛 🤔 💻 948720857🐛 谦君🤔 suheandzl🐛 Enkianssus🤔 不会飞的麻将🤔 streamstack-cn🤔 白影White🤔 IXnAh1L🐛 EGOIST🐛 yanfd🐛 Tony Smith💻

法律与免责声明

本项目在 AI 的广泛协助下开发，因此仍可能存在细微或不易察觉的问题。若给你带来不便，敬请理解。 本项目主要用于展示播放动效、界面设计与相关工程实现。应用中涉及的在线音乐流媒体、歌词、专辑封面及其他内容，其版权均归对应权利人所有。 本仓库及其源代码仅供个人学习、技术交流与非营利测试使用。请勿将其用于商业盈利用途。若因对在线资源的传播、加工或再分发而引发版权纠纷或其他责任，均由使用者自行承担，项目开发者不承担相关责任。 请始终尊重数字版权，并在条件允许时通过官方平台支持正版音乐。

致谢

特别感谢以下项目和资源：

• chenmozhijin/LDDC (https://github.com/chenmozhijin/LDDC)
• NeteaseCloudMusicApiEnhanced (https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced)
• chenglou/pretext (https://github.com/chenglou/pretext)

本项目接入了 Apple Music-like Lyrics TTML 逐词歌词库 (https://github.com/amll-dev/amll-ttml-db) 以提供高质量的歌词文件，感谢此歌词库的作者和贡献者们。

许可证

本项目基于 AGPL-3.0 许可证开源。