Folia 全屏歌词播放器快速教程3 种来源、5 步让第一首歌铺满全屏【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款以全屏歌词动画为核心的音乐播放器覆盖本地曲库、Navidrome 与网易云、QQ 音乐、酷狗等在线平台三种来源。这篇教程帮你定好歌曲来源、装起来并启动、把第一首歌播到全屏歌词页顺手学会键盘上的日常操作。Folia 歌曲来源怎么选本地曲库、Navidrome 还是在线平台装之前先问一句你的歌是躺在自己电脑里、放在自建服务器上还是全靠在线平台这个选择决定了后面每一步走哪个入口。歌曲来源从哪个入口进什么时候选它提前要知道的事本地音乐文件Folder页签文件在自己电脑上离线也能听需要先导入一个音乐目录Navidrome 自建服务器Navi页签已部署流媒体服务器多设备共用得先在设置里填好服务器地址网易云 / QQ 音乐 / 酷狗首页顶部搜索框手头没有本地文件随搜随听未登录只能听 30 秒试听片段拿不准就先走本地曲库不碰账号、不依赖网络导入即可听是门槛最低的一条路。本地目录导入后以文件夹卡片形式陈列点卡片就按目录层级往下浏览。Navidrome 配置完成后首页直接呈现曲库内容浏览体验与本地库接近。在线平台则完全免配置打开即能搜在搜索页签里直接点播。Folia 安装两条路线桌面版安装包与 Web 开发环境路线一桌面版多数人首选。到 Releases 页面取回 Windows / macOS / Linux 对应平台的安装包跟着向导装完即用。前后端运行环境都已打包在内无需准备任何依赖Linux 下.deb、.rpm、tar.gz三种格式任选其一。桌面版还支持波点音乐、YouTube Music、Spotify 与汽水音乐这四种 Web 版没有的来源。路线二本地开发跑 Web 版。先备好 Node.js 24 及以上版本然后git clone https://gitcode.com/GitHub_Trending/fo/folia-major cd folia-major npm install npm run dev用浏览器打开终端提示的地址完整界面就出来了。怎么算启动成功首页顶部出现一排Playlists / Radio / Albums / Folder / Navi页签封面卡片加载出来右上角搜索框负责在线平台检索右下角悬浮按钮展开各平台的登录入口。Folia 第一次播放本地曲库 5 步入全屏歌词以最常走的本地曲库为例点顶部Folder页签进入本地音乐区域工具栏上点Import Folder在系统目录选择窗口里选中你的音乐目录扫描期间先别动Folia 会递归读取子目录里的音频、同目录.lrc歌词与内嵌封面曲库较大时后台读元数据要花点时间扫描结束后在海报墙里点All Songs或任意文件夹卡片单击任意一首歌声音和封面立刻出现进入全屏歌词页后按一次H收起控制条歌词动画铺满整屏。满屏的歌词动画开始跳动就代表第一次播放成功了。歌来自在线平台的话路线更短页签停在任一在线平台上在右上角搜索框输入歌名或歌手占位文字显示「搜索在线歌曲...」在结果列表单击即播。想把某首歌留住在歌曲菜单里选「收藏」成功后会弹出「已添加到喜欢的音乐」的提示。用键盘当 Folia 遥控器高频快捷键速查进入播放状态后绝大多数动作不碰鼠标也能完成。按键定义可在 src/components/modal/userGuideContent.ts 中查看下表覆盖日常 90% 的操作用来做什么按哪个键提示收起或恢复控制条H把整屏留给歌词动画播放或暂停Space使用频率最高的键前后跳转 5 秒←/→不用拖着进度条走切上一首 / 下一首Ctrl ←/Ctrl →macOS 换成Cmd调出命令面板S见下方提示打开播放队列Ctrl PmacOS 为Cmd P开合右侧面板P再按Tab轮换面板页签S调出的命令面板值得单独记直接敲汉字或拼音——「切歌」「收藏」都能命中动作比在菜单里逐层翻找快得多。Folia 新手排障最容易碰到的三堵墙与对策你会看到为什么会这样怎么办在线歌曲播到 30 秒就中断未登录状态下平台只放出试听片段点右下角悬浮按钮展开平台登录入口扫码登录后完整播放恢复自己的在线歌单与收藏也能用重启应用后本地曲库变灰点歌无反应目录读取权限被浏览器或系统收回看到「需要恢复本地音乐访问权限」提示时按引导重新授权目录被移动或改名过则重新导入该文件夹网页版找不到可用的导入入口浏览器不支持读取本地文件夹的 File System Access API换 Chrome 等支持该 API 的浏览器或直接用桌面版详见 docs/local-library-management.md 音乐目录里混着不想入库的临时音频时在根目录放一个.foliaignore文件即可排除规则写法与.gitignore相同改完对该目录执行一次「重新导入」生效。Folia 接下来可以试什么从主题到多设备同步换歌词动画主题浮名、流光、群唱等各有排版氛围与可调参数在播放页直接切换效果预览见 README.md 的主题展示区智能匹配本地歌曲可自动匹配在线歌词与封面匹配不准时支持手动修正模组系统桌面版实验性在「设置 → 模组 → 模组系统」开启可扩展新的歌词动画、背景与播放页图层sync-server自行托管后多台设备间同步外观设置与 AI 主题库。部署、环境变量与 Stage API 等更深的技术细节集中在 docs/technical.md。跑通「导入 → 播放 → 切歌 → 收藏」这条主线后下一步值得做的是挑一个顺眼的歌词主题再打开自动在线匹配。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
