Folia Major (setube 版)

Lyrics Reimagined // 辞曲新境

基于 chthollyphile/folia-major 的二次开发版本

关于本项目

本仓库是 Folia Major 的二次开发分支，在上游版本的基础上增加了若干上游未纳入规划的功能。

上游项目是一个以全屏沉浸式歌词播放为核心的音乐播放器，支持网易云、酷狗、Navidrome 和本地音乐库，通过智能歌词匹配、AI 生成配色主题以及多种全屏歌词动画提供听歌体验。核心功能与架构均来自上游，本仓库仅在其之上做增量修改。

本仓库保留了上游的完整提交历史，二次开发的改动为 c1d2dd3 及其之后的提交。

Important

本仓库与上游项目没有隶属关系，并非官方分支，请勿向上游反馈本仓库引入的问题。 如果你需要的是原版，请前往 chthollyphile/folia-major。

核心能力

模块	说明
在线搜索与播放	搜索歌曲、歌手或专辑后即可播放，并自动加载相关封面与歌词。
本地音乐支持	可导入本地音频文件，在本地保存索引信息，不上传文件内容。
智能歌词匹配	本地歌曲可自动匹配在线歌词与封面，也支持手动修正匹配结果。
本地歌词文件识别	自动加载同目录同名 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 歌词文件。
Now Playing 接入	支持通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴与歌词信息。
AI 主题生成	基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。
多端体验	提供 Web 部署方式，同时支持桌面端打包分发。

构建与开发

本项目要求 Node.js 24 或更高版本。

npm install
cp .env.example .env.local   # 按需填写环境变量
npm run dev                  # Web 开发服务器
npm run dev:electron         # Electron 开发模式
npm run build:electron       # 打包桌面端

需要自行部署 NeteaseCloudMusicApiEnhanced 提供后端服务，并配置 VITE_NETEASE_API_BASE。AI 主题功能需要配置 Gemini 或 OpenAI 兼容接口。详细的环境变量说明见 .env.example 与上游的技术说明文档。

法律与免责声明

本项目主要用于展示播放动效、界面设计与相关工程实现。应用中涉及的在线音乐流媒体、歌词、专辑封面及其他内容，其版权均归对应权利人所有。

本仓库及其源代码仅供个人学习、技术交流与非营利测试使用。请勿将其用于商业盈利用途。若因对在线资源的传播、加工或再分发而引发版权纠纷或其他责任，均由使用者自行承担，项目开发者不承担相关责任。

请始终尊重数字版权，并在条件允许时通过官方平台支持正版音乐。

版权与许可

本项目基于 AGPL-3.0 许可证开源，与上游项目保持一致。

原始项目版权归 chthollyphile 及其贡献者所有：

• 上游仓库：https://github.com/chthollyphile/folia-major
• 上游贡献者名单：CONTRIBUTORS.md
• 许可证全文：LICENSE

本仓库在上游代码基础上进行修改，修改内容以 commit 历史为准，同样以 AGPL-3.0 授权。依据 AGPL-3.0，任何基于本项目的衍生作品在分发或通过网络提供服务时，同样需要以 AGPL-3.0 开放源代码。

致谢

特别感谢上游项目 chthollyphile/folia-major 及其全体贡献者。

同时感谢以下项目和资源：

• chenmozhijin/LDDC
• NeteaseCloudMusicApiEnhanced
• chenglou/pretext
• MakcRe/KuGouMusicApi
• paper-design/shaders

本项目接入了 Apple Music-like Lyrics TTML 逐词歌词库 以提供高质量的歌词文件，感谢此歌词库的作者和贡献者们。