TIP
文档建设中，欢迎提交 Pull Request 来完善它！文档 GitHub 地址
用户指南
Folia 是一款以歌词为中心的播放器。它把在线音乐、本地音乐、Navidrome 曲库、舞台模式和 AI 主题整合到同一套播放体验里。
TIP
如果你遇到问题，可以先查看 常见问题
这份文档适合谁
- 普通用户：想快速上手播放、导入本地音乐、切换视觉模式。
- 桌面端用户：想使用遥控窗、视频录制、Stage Mode、Now Playing 接入。
- 进阶用户：想把 Navidrome、自建 API 或外部工具接入 Folia。
你可以在 Folia 里做什么
| 能力 | 说明 |
|---|---|
| 在线播放 | 搜索网易云歌曲并直接播放、查看歌词和封面。 |
| 本地音乐库 | 导入文件夹，自动读取音频标签、封面、内嵌歌词和同目录歌词文件。 |
| Navidrome 接入 | 连接私有音乐库，浏览专辑、歌手、播放列表和随机歌曲。 |
| 多种歌词视觉模式 | 内置 流光、心象、云阶、浮名、群唱 等模式。 |
| AI 主题 | 根据歌词或纯音乐标题生成明暗双主题配色。 |
| 舞台模式 | 接收外部歌词或媒体输入，驱动 Folia 的沉浸式播放页。 |
| 桌面增强 | 提供独立遥控窗、视频录制、系统更新和平台级窗口控制。 |
推荐阅读顺序
如果你准备自己部署或二次接入，请继续看 开发者文档。