chthollyphile/folia-major

GitHub Trending (daily) Products

lyrics-player music-player netease-cloud navidrome ai-theme fullscreen-animation open-source

Summary

Folia是一个开源的全屏沉浸式歌词音乐播放器，支持网易云、navidrome和本地音乐库，利用AI生成配色主题和多种全屏歌词动画，提供独特的听歌体验。

专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方网易云播放器

Original Article

View Cached Full Text

Cached at: 07/04/26, 12:39 PM

chthollyphile/folia-major

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

Folia

Lyrics Reimagined // 辞曲新境

桌面版下载 · Vercel 部署 · 使用指南 · 技术说明

项目简介

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

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

如果希望能够在移动设备上使用，或在浏览器上体验云端多平台，可以选择一键部署到 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 服务接入外部播放器的歌曲、时间轴与歌词信息，并驱动 Folia 的舞台视图与全屏歌词渲染。
AI 主题生成	基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。
多端体验	提供 Web 部署方式，同时支持桌面端打包分发。

桌面端下载

桌面版内置前后端运行环境，适合希望即装即用的用户。最新版本请前往 Releases 页面。

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

文档与开发

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

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

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

本地音乐与匹配说明

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

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

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

贡献者

Thanks goes to these wonderful people. Issue reports, bug reports, ideas, docs, design, tests, and code are all counted through the all-contributors spec.

_冬霧 💻	_{zhao_alpha} 🐛	_hz1ang 🐛 🤔	_steadyoak 🐛 🤔	_POINTER 🐛 🤔	_Yuki-3939 🤔	_MewsCat 🐛 🤔
_tumuyan 🐛 🤔 💻	_948720857 🐛	_谦君 🤔	_suheandzl 🐛	_Enkianssus 🤔	_{不会飞的麻将} 🤔	_{streamstack-cn} 🤔
_白影White 🤔	_IXnAh1L 🐛	_EGOIST 🐛	_yanfd 🐛	_{Tony Smith} 💻