chthollyphile/folia-major

▲ 6,837 stars today★ 10,136⑂ 1,113

专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器

About chthollyphile/folia-major

chthollyphile/folia-major is an open-source project on GitHub, mainly written in TypeScript. 专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 It currently holds 10,136 stars and 1,113 forks with 86 open issues, and was last pushed on 2026-10-29 (repository created 2025-11-28).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository chthollyphile/folia-major · default branch main · size 56896 KB · watchers 20 · source: GitHub REST API and repository README

README

https://github.com/chthollyphile/folia-major/blob/HEAD/Folia

https://github.com/chthollyphile/folia-major/blob/HEAD/chthollyphile%2Ffolia-major | Trendshift

Folia

Lyrics Reimagined // 辞曲新境

简体中文 | English

GitHub release License GitHub stars Node.js Ask DeepWiki Discord

All Contributors

获取方式 · Vercel 部署 · 使用指南 · 技术说明

项目简介

Folia是一个以全屏沉浸式歌词播放为核心的在线音乐播放器,支持网易云、酷狗、QQ 音乐、Navidrome 和本地音乐库,桌面端还支持波点音乐、YouTube Music、Spotify 和汽水音乐,通过智能歌词匹配,AI生成配色主题,以及多种全屏歌词动画为用户提供独特的听歌体验。

提供基于Electron的 windows/ macOS/ Linux 桌面端版本与基于 Node.js 的 Web 版本,支持多平台部署。

如果希望能够在移动设备上使用,或在浏览器上体验,可以选择一键部署到 Vercel 的 Web 版本,或自行部署到其他支持 Node.js 的平台。

快速下载

[!TIP]
- GitHub:Latest Release,提供 Windows / macOS / Linux 全平台安装包。
- 网盘:夸克网盘 · 百度云(提取码 flia),适合国内网络,仅提供 Windows 与 Apple silicon 的正式版安装包。
> 更多获取方式(Web 部署、Docker、AUR、Flatpak、移动端)见下方 获取方式。

展示

visualizer

在线体验(社区版)

在浏览器里直接试用:folia.tangbot.xyz

[!NOTE]
这是社区部署的演示站,仅供体验,部署来源为 maimai993/folia-sonnet。它包含社区作者自己的改动,与官方 Web 版并不完全一致;使用中遇到问题请反馈到该社区仓库。长期使用建议下载桌面版或自行部署。

演示视频

https://github.com/user-attachments/assets/af806cf1-f67f-4b88-b2e7-57db507e9e81

https://github.com/user-attachments/assets/fd27f4f0-64b9-4c57-8c3b-10df767f934b

https://github.com/user-attachments/assets/704f195a-2194-434b-86e8-8f36290e5cc4

部分主题预览

https://github.com/chthollyphile/folia-major/blob/HEAD/Fume 主题预览 https://github.com/chthollyphile/folia-major/blob/HEAD/Lumi 主题预览
浮名 流光
https://github.com/chthollyphile/folia-major/blob/HEAD/Cad 主题预览 https://github.com/chthollyphile/folia-major/blob/HEAD/Pat 主题预览
心象 云阶
https://github.com/chthollyphile/folia-major/blob/HEAD/群唱 主题预览 https://github.com/chthollyphile/folia-major/blob/HEAD/Tilt 主题预览
群唱 倾诉
https://github.com/chthollyphile/folia-major/blob/HEAD/镜台 主题预览 https://github.com/chthollyphile/folia-major/blob/HEAD/时计 主题预览
镜台 时计

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

核心能力

| 模块 | 说明 | | --- | --- | | 在线搜索与播放 | 搜索歌曲、歌手或专辑后即可播放,并自动加载相关封面与歌词。 | | 本地音乐支持 | 可导入本地音频文件,在本地安全保存索引信息,不上传文件内容。详细用法见 本地音乐库管理。 | | 智能歌词匹配 | 本地歌曲可自动匹配在线歌词与封面,也支持手动修正匹配结果。 | | 本地歌词文件识别 | 自动加载同目录同名 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 歌词文件,或歌词文件内嵌 LRC 歌词。适配 LDDC 生成的增强型逐字歌词格式。 | | Now Playing 接入 | 支持通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴与歌词信息,并驱动 Folia 的舞台视图与全屏歌词渲染。 | | AI 主题生成 | 基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。 | | 多端体验 | 提供 Web 部署方式,同时支持桌面端打包分发。 | | 模组系统(实验性) | 桌面版可通过 Folium 模组添加歌词动画、背景、播放页图层、命令等,并从 模组市场 安装官方认证的模组。详见 模组系统。 |

获取方式

桌面版内置前后端运行环境,适合希望即装即用的用户。

一键部署

如果你希望快速上线 Web 版本,请阅读 Vercel 一键部署指南 来创建项目

Deploy with Vercel

项目也支持一键部署到 Cloudflare,请参考 Vercel 的部署教程进行相应调整。

Deploy to Cloudflare

Vercel 与 Cloudflare 上的 QQ 音乐不再需要额外部署一个常驻 API 实例:把 VITE_QQ_API_BASE 填成 /api/qq,再配一个 QQ_SESSION_SECRET(服务端密钥,不加 VITE_ 前缀)即可。这种形态支持微信扫码和手机 QQ 扫码登录(手机 QQ 扫码要 qq-music-api 3.3.3 或更高版本),且播放前必须先登录;Cloudflare 上可以再绑定一个 Durable Object,让 QQ 扫码改走长连接,并多一个 QQ 音乐 App 扫码。完整步骤、平台差异和排错方法见 QQ 音乐部署指南。

自托管用户可以使用 Docker Compose 全栈部署。本地音乐目录访问依赖可信 HTTPS 安全上下文,部署文档包含 NAS 反向代理和证书要求。

直接下载

[!IMPORTANT]
如果国内网络从 GitHub Releases 下载较慢,可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包.

Linux 包、Wayland / Hyprland 遥控窗和桌面端细节见 技术与开发说明。

移动端

| 方式 | 说明 | | --- | --- | | PWA(推荐) | 部署 Web 版本或自托管版本后,在 Chrome for Android / iOS Safari 中将网页添加到主屏幕,即可作为 PWA 应用使用。 | | 社区移植版(Android) | maimai993/folia-sonnet · whycfawa/folia-android | | 自行打包(Android) | 有一定技术基础的用户可以用 Capacitor 将 Web 版本打包为可安装的 APK,参考示范仓库 chthollyphile/folia-sonnet。 |

[!NOTE]
社区移植版均为第三方项目,由社区自发维护,功能会与官方 PC 版存在差异。使用中遇到问题请反馈到对应的社区仓库。

文档与开发

更完整的使用说明请访问 Folia Guide。

部署、环境变量、本地开发、Stage API、常用脚本和技术栈见 技术与开发说明。

模组系统(Folium v1.x)

[!NOTE]
模组系统是实验性功能,仅桌面版可用,默认关闭,需要在「设置 → 模组 → 模组系统」中开启。

Folium 是 Folia 的模组平台。模组可以添加新的歌词动画模式和背景类型、在播放页上叠加内容、给进度条加按钮和标记、注册命令与设置分区、在歌词显示前改写歌词,也可以通过 Node 入口调用 ffmpeg 等本地能力。模组以可信代码运行,每个模组在启用前都要在原生窗口中确认,文件变化后需要重新确认。

Sync Server

Folia 提供了可选的官方同步服务端 sync-server,用于在多个设备之间同步外观设置与 AI 主题库。服务端由用户自行托管,适合希望跨设备同步配色主题的用户。

支持以下部署方式:

Deploy to Cloudflare Workers 详细的环境变量、Token 配置与部署步骤请参阅 Sync-Server 部署指南。部署完成后,在 Folia 的「设置 → 连接与集成」中填写服务端地址和 SYNC_TOKEN 即可启用同步。

本地音乐与匹配说明

Folia 会读取音频文件元数据、同目录歌词和封面,并可通过网易云、QQ 音乐或酷狗音乐补全歌曲信息。自动匹配按网易云、QQ、酷狗依次回退;匹配不准确时,可以手动选择候选、恢复首次导入的本地信息,或进一步合并、拆分艺术家与专辑实体。

完整的导入、重扫、匹配、实体编辑、歌单、缓存和故障排查说明见 本地音乐库管理。

Community

加入discord社群,共同交流,获得帮助

Discord

贡献者

感谢所有为本项目进行 Issue 提交、Bug 报告、想法建议、测试与代码编写的贡献者,均依据 all-contributors 规范进行统计

由于列表过长,贡献记录请见 贡献者名单。

法律与免责声明

本项目在 AI 的广泛协助下开发,因此仍可能存在细微或不易察觉的问题。若给你带来不便,敬请理解。

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

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

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

致谢

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

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

许可证

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

GitHub Stars & Activity

10,136Stars
1,113Forks
86Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars10,136
Forks1,113
Open issues86
Primary languageTypeScript
LicenseAGPL-3.0
Stars gained today6,837
Created2025-11-28
Last pushed2026-10-29

Trending History

Monthly boardrank #40 · ▲ 6,837 stars

Related GitHub Projects

1

ChromeDevTools / chrome-devtools-mcp

TypeScript★ 55,847⑂ 4,626▲ 67 stars
→
2

abhigyanpatwari / GitNexus

TypeScript★ 48,534⑂ 5,262▲ 48 stars
→
3

QwenLM / qwen-code

TypeScript★ 30,137⑂ 3,418▲ 462 stars
→
4

lidge-jun / opencodex

TypeScript★ 18,513⑂ 1,474▲ 54 stars
→
5

a2ui-project / a2ui

TypeScript★ 17,332⑂ 1,405▲ 117 stars
→
6

thesysdev / openui

TypeScript★ 15,201⑂ 1,012▲ 35 stars
→
7

openai / codex-security

TypeScript★ 13,366⑂ 1,034▲ 751 stars
→
8

CopilotKit / OpenBot

TypeScript★ 12,177⑂ 1,500▲ 674 stars
→

More Trending Repositories