Folia：沉浸式歌词动画音乐播放器

项目简介

Folia 是一款以全屏沉浸式歌词播放为核心的音乐播放器，支持网易云、酷狗、QQ 音乐、Navidrome 和本地音乐库，桌面端还支持波点音乐、YouTube Music、Spotify 和汽水音乐。它通过智能歌词匹配、AI 生成配色主题和多种全屏歌词动画，让听歌拥有如同文字 PV 般的视觉效果。

项目提供基于 Electron 的 Windows / macOS / Linux 桌面版，以及基于 Node.js 的 Web 版本，可一键部署到 Vercel、Cloudflare，或自行自托管。

主要功能

• 在线搜索与播放：搜索歌曲、歌手或专辑后即可播放，并自动加载封面与歌词。
• 本地音乐支持：可导入本地音频文件，索引信息保存在本地，不上传文件内容。
• 智能歌词匹配：本地歌曲可自动匹配在线歌词与封面，也支持手动修正匹配结果。
• 本地歌词文件识别：自动加载同目录同名的 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 歌词文件或内嵌 LRC 歌词，并适配 LDDC 生成的增强型逐字歌词。
• Now Playing 接入：可通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴与歌词信息，驱动舞台视图与全屏歌词渲染。
• AI 主题生成：基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。
• 多套歌词动画主题：浮名、流光、心象、云阶、群唱、倾诉、镜台、时计等，各有排版氛围与可调参数，并自动适配不同窗口尺寸。
• 模组系统（实验性）：桌面版可通过 Folium 模组添加歌词动画、背景、播放页图层、命令等，并可从模组市场安装官方认证模组。
• Sync Server：可选的自托管同步服务端，用于在多设备间同步外观设置与 AI 主题库。

安装与使用

桌面端：前往 Releases 页面下载对应安装包；国内网络也可使用 README 中给出的夸克网盘、百度云链接，网盘仅提供 Windows 与 Apple silicon 的正式版安装包。

• Windows：下载 Folia-Setup-<version>.exe
• macOS：Apple Silicon 下载 Folia-<version>-arm64.dmg，Intel 下载 Folia-<version>-x64.dmg
• Arch Linux / Manjaro：yay -S folia-major-bin
• Debian / Ubuntu：下载 folia-major-<version>-linux-amd64.deb
• Fedora / openSUSE：下载 folia-major-<version>-linux-x86_64.rpm
• 其他发行版：下载 folia-major-<version>-linux-x64.tar.gz

Web 端：可通过 Vercel 或 Cloudflare 一键部署，也可使用 Docker Compose 全栈部署到自托管环境。

移动端：部署 Web 版本后，在 Chrome for Android 或 iOS Safari 中把网页添加到主屏幕，即可作为 PWA 使用；Android 另有社区第三方移植版。

更完整的使用说明见 Folia Guide。

注意事项

• 模组系统为实验性功能，仅桌面版可用，默认关闭，需在「设置 → 模组 → 模组系统」中开启。
• macOS 打开时若提示「应用已损坏」，通常是因为安装包未签名、未 notarize，被 Gatekeeper 拦截，并非安装包损坏，可参考仓库中的说明文档处理。
• 在线音乐、歌词、专辑封面等内容的版权归对应权利人所有；项目仅供个人学习、技术交流与非营利测试使用，请勿用于商业用途。
• 项目基于 AGPL-3.0 许可证开源。

本作品整理自 GitHub 开源项目 chthollyphile/folia-major，原作者 @chthollyphile，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。