Folia 播放器使用教程：5 分钟跑通搜歌、播放、收藏的完整闭环

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一款主打全屏沉浸式歌词动画的音乐播放器，曲库同时覆盖本地音乐库、Navidrome 与网易云、QQ 音乐、酷狗。这篇 Folia 播放器使用教程带你走完「搜歌 → 播放 → 切歌 → 收藏」一整圈听歌闭环，并顺手解锁全屏歌词动画、智能歌词匹配和 AI 主题生成三个进阶能力。

装完打开 Folia：主界面只需记 3 个入口

首页是一张「海报墙」，歌单、专辑、文件夹都以卡片铺开，点任意一张卡片就进它的歌曲列表。真正要记的只有下面三处：

本地、Navidrome 与在线平台互不干扰，切页签就等于切换「去哪儿搜」。

🔍 3 步搜到第一首歌：搜索框里的最小闭环

这一节解决「怎么快速定位到想听的那首」：

1. 顶部页签选来源：Folder、Navi或在线平台；
2. 搜索框输入「周杰伦」等关键词；
3. 结果列表点一首歌，进入全屏歌词播放页。

占位提示会跟着来源自动变，例如搜索在线歌曲...、搜索本地歌曲...、搜索navidrome...，文案定义见 搜索提示文案。

💡 提示：忘切页签也没关系，按S打开命令面板，输入「搜索歌曲」「搜索 Navidrome」等汉字或拼音都能触发，比鼠标点找更快（见 命令面板组件）。

在线歌曲只能听半段？登录三步解锁完整播放

未登录时，部分在线歌曲只给 30 秒试听，也进不了在线歌单与收藏专辑。解锁步骤很短：

1. 点右下角悬浮按钮，展开平台入口；
2. 扫码或账号密码登录该平台；
3. 登录成功，完整播放并管理在线歌单。

QQ 音乐的部署与登录差异见 QQ 音乐部署指南。

Folia 快捷键一览：不碰鼠标完成播放与切歌

这一节解决「怎么把听歌节奏握在自己手里」。进入播放页后，常用键如下，完整定义见 播放页快捷键清单：

除键盘外，进度条标题两侧悬停会浮出「上一首 / 下一首」箭头；在设置里打开「始终显示切歌箭头」后，它们会常驻，不用每次悬停。

💡 提示：切到歌词页按H藏起控制条，画面只剩歌词动画，最适合沉浸地听。

Folia 收藏歌曲：两条路把好听的留下来

这一节解决「听进歌了，怎么存下来」。收藏入口都在歌曲卡片菜单里：

• 存成喜欢的音乐：菜单选「收藏」，成功后提示「已添加到喜欢的音乐」；
• 放进指定歌单：选「添加到歌单」，新建或选已有歌单，提示「歌单已更新」。

本地歌曲还支持在海报墙里多选后，一键把选中歌曲存成歌单，省去逐首操作；在线歌单的隐藏、切换、导入导出 M3U 等管理入口在首页Playlists页签，详见 本地音乐库管理文档。

🎧 进阶：让 Folia 从能用到好玩的三件套

这一节把 Folia 从「能用」推向「好玩」，三个招牌能力各花两分钟体验。

• 全屏歌词动画：切到歌词页按H隐藏控制条，浮名、流光、群唱等多款动画像文字 PV 一样铺满整屏，主题预览见 README 展示区。
• 智能歌词匹配：本地歌曲导入后按 网易云 → QQ → 酷狗 的顺序自动补全歌词与封面；匹配不准时可在匹配窗口手动选候选、恢复首次导入的本地信息。
• AI 主题生成：根据歌曲情绪自动生成沉浸式背景与配色，接口与 worker 端实现分别在 主题生成接口 与worker/generate-theme.ts。

收尾：3 秒回忆整条听歌闭环

顶部选来源 → 右上搜索 →Space播放 →Ctrl + →切歌 → 菜单里收藏。

把这条流程跑顺，Folia 就能当日常播放器用了；更多部署、Navidrome 配置、Stage API 的细节，直接查 docs/technical.md。

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major