https://github.com/chthollyphile/folia-major

专注于绚丽的歌词动画效果的第三方网易云播放器
https://github.com/chthollyphile/folia-major

ai music music-player navidrome-client netease-music player pwa react typescript vercel-deployment

Last synced: 18 days ago
JSON representation

专注于绚丽的歌词动画效果的第三方网易云播放器

Host: GitHub
URL: https://github.com/chthollyphile/folia-major
Owner: chthollyphile
License: agpl-3.0
Created: 2025-11-28T11:58:07.000Z (7 months ago)
Default Branch: main
Last Pushed: 2026-06-06T20:36:54.000Z (23 days ago)
Last Synced: 2026-06-06T22:19:17.410Z (23 days ago)
Topics: ai, music, music-player, navidrome-client, netease-music, player, pwa, react, typescript, vercel-deployment
Language: TypeScript
Homepage: https://folia-site.vercel.app/
Size: 10.4 MB
Stars: 110
Watchers: 0
Forks: 14
Open Issues: 6
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md

Awesome Lists containing this project

README

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/)

[![All Contributors](https://img.shields.io/badge/all_contributors-11-orange.svg?style=flat-square)](#contributors-)

[桌面版下载](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

### 主题预览

Fume 主题预览

Lumi 主题预览

浮名
流光

Cad 主题预览

Pat 主题预览

心象
云阶

群唱主题预览

Tilt 主题预览

群唱
倾诉

不同的歌词动画具有不同的排版氛围和可调参数，让全屏歌词拥有如同文字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. 在线匹配结果

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

## 贡献者

Thanks goes to these wonderful people. Issue reports, bug reports, ideas, docs, design, tests, and code are all counted through the [all-contributors](https://allcontributors.org/) spec.

_冬霧
 💻

_{zhao_alpha}
🐛

_hz1ang
🐛 🤔

_steadyoak
🐛 🤔

_POINTER
🐛 🤔

_Yuki-3939
🤔

_MewsCat
🐛 🤔

_tumuyan
🐛 🤔 💻

_948720857
🐛

_谦君
 🤔

_suheandzl
🐛