chthollyphile/folia-major

GitHub: chthollyphile/folia-major

一款支持网易云、Navidrome 和本地音乐库的沉浸式歌词动画播放器，以全屏炫彩歌词展示为核心卖点。

Stars: 1041 | Forks: 68

Folia

# Folia Lyrics Reimagined // 辞曲新境 [![GitHub release](https://img.shields.io/github/v/release/chthollyphile/folia-major?label=release)](https://github.com/chthollyphile/folia-major/releases) [![License](https://img.shields.io/github/license/chthollyphile/folia-major)](https://github.com/chthollyphile/folia-major/blob/main/LICENSE) [![GitHub stars](https://img.shields.io/github/stars/chthollyphile/folia-major?style=social)](https://github.com/chthollyphile/folia-major/stargazers) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)](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/) · [技术说明](docs/technical.md)

## 项目简介 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般的丰富视觉效果，同时又能兼顾响应式布局，自动适配不同窗口尺寸。 ## 核心能力 | 模块 | 说明 | | --- | --- | | 在线搜索与播放 | 搜索歌曲、歌手或专辑后即可播放，并自动加载相关封面与歌词。 | | 本地音乐支持 | 可导入本地音频文件，在本地安全保存索引信息，不上传文件内容。 | | 智能歌词匹配 | 本地歌曲可自动匹配在线歌词与封面，也支持手动修正匹配结果。 | | LRC 文件识别 | 自动加载同目录同名 `.lrc` 歌词文件，或歌词文件内嵌lrc歌词。适配 LDDC 生成的增强型逐字歌词格式 | | Now Playing 接入 | 支持通过本机 [Now Playing](https://github.com/Widdit/now-playing-service/) 服务接入外部播放器的歌曲、时间轴与歌词信息，并驱动 Folia 的舞台视图与全屏歌词渲染。 | | AI 主题生成 | 基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。 | | 多端体验 | 提供 Web 部署方式，同时支持桌面端打包分发。 | ## 桌面端下载桌面版内置前后端运行环境，适合希望即装即用的用户。最新版本请前往 [Releases 页面](https://github.com/chthollyphile/folia-major/releases)。 Linux 包、Wayland / Hyprland 遥控窗和桌面端细节见 [技术与开发说明](docs/technical.md)。 ## 文档与开发更完整的使用说明请访问 [Folia Guide](https://folia-site.vercel.app/guide/)。部署、环境变量、本地开发、Stage API、常用脚本和技术栈见 [技术与开发说明](docs/technical.md)。如果你希望快速上线 Web 版本，请阅读 [Vercel 一键部署指南](https://folia-site.vercel.app/guide/deploy-vercel) 来创建项目 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/chthollyphile/folia-major) ## 本地音乐与匹配说明使用本地音乐时，Folia 会优先尝试从以下来源补全信息： 1. 音频文件自身元数据 2. 同目录同名歌词文件 3. 在线匹配结果如果自动匹配不准确，可以在播放界面的右侧面板进入“本地”选项卡，手动搜索并指定更合适的歌词、封面或元数据来源。你也可以选择只使用本地信息，关闭在线匹配结果。 ## 法律与免责声明本项目在 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` 许可证开源。

标签：Electron, GNU通用公共许可证, MITM代理, Navidrome, Node.js, Web前端, 桌面应用, 网易云音乐, 自动化攻击, 音乐播放器