Folia 五分钟上手:本地音乐进全屏歌词动画的最短路径

Folia 五分钟上手:本地音乐进全屏歌词动画的最短路径

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

Folia 是一款把全屏歌词动画放在核心位置的音乐播放器,本地曲库、Navidrome、网易云、QQ 音乐、酷狗都能接。照做完安装、导入、播放三件事,当控制条消失、歌词铺满屏幕的那一刻,就算跑通了。

Folia 最快安装方式:桌面版与本地 Web 版

两条路任选,装完打开都是完整界面。

  1. 桌面版(推荐):从 Releases 下载对应平台安装包(Windows / macOS / Linux),前后端环境已内置,即装即用。
  2. 本地跑 Web 版:准备 Node.js 24 及以上,git clone https://gitcode.com/GitHub_Trending/fo/folia-major 克隆仓库,再依次执行 npm install 与 npm run dev,浏览器打开即完整 Folia。

Folia 播放器界面,封面 3D 轮播与顶部在线搜索框

启动后认准三处:顶部页签条(Playlists / Radio / Albums / Folder / Navi)决定翻哪个库;右上角搜索框管在线搜歌;右下角悬浮按钮是各平台的登录入口。

三种歌曲来源怎么选:本地曲库、Navidrome、在线平台

歌从哪来,先定一个。

  • 本地曲库:走 Folder 页签,音乐在自己电脑上,不用账号,新手最省心;
  • Navidrome:走 Navi 页签,在设置里填好服务器地址,适合自建音乐服务器;
  • 在线平台:右上角搜索框直接搜,未登录时部分歌曲只开放 30 秒试听。

Folia 播放器本地曲库 Folder 页签,Import Folder 导入按钮与 All Songs 海报卡片

第一次用建议直接选本地曲库:不依赖网络登录,打开就能听。

导入本地音乐:五步播起第一首歌

最短路径五步,每步都不超过十秒。

  1. 点顶部 Folder 页签;
  2. 点工具栏 Import Folder,在系统目录选择器里选中音乐目录;
  3. 等扫描完成:Folia 会递归读子目录的音频、同目录 .lrc 歌词与内嵌封面,大目录稍等片刻;
  4. 点进 All Songs,单击任意歌曲开始播放;
  5. 全屏歌词页按一次 H:控制条消失,歌词动画铺满屏幕——这就是 Folia 的招牌体验。

Folia 播放器全屏歌词动画界面,逐行歌词排版与歌曲卡片列表

走在线平台更短:搜索框输入歌名或歌手,结果里单击即播;歌曲菜单选「收藏」可留存,成功会提示「已添加到喜欢的音乐」。

Folia 播放快捷键速查:不碰鼠标也能听

进入播放状态后,高频操作全部交给键盘:

操作按键说明
播放 / 暂停Space用得最多的一个键
上一首 / 下一首Ctrl + ← / Ctrl + →macOS 换成 Cmd
快退 / 快进 5 秒← / →进度微调不用点进度条
打开命令面板S汉字、拼音都能触发
打开队列面板Ctrl + PmacOS 为 Cmd + P
隐藏 / 显示控制条H专注全屏歌词动画

💡 命令面板按 S 打开后,输入「切歌」「收藏」这类词直接执行,比逐层翻菜单快得多。完整按键定义见 src/components/modal/userGuideContent.ts。

三个新手常见故障:30 秒试听、权限收回、导入失败

  1. 在线歌曲 30 秒就停:未登录只有试听额度。点右下角悬浮按钮展开平台入口,扫码登录即可完整播放,在线歌单与收藏一并解锁。
  2. 重启后本地曲库变灰、歌曲播不了:系统收回了目录读取权限。看到「需要恢复本地音乐访问权限」就按提示重新授权;目录被移动或改名则重新导入。
  3. Web 版提示不支持文件夹导入:该能力依赖浏览器的 File System Access API,换支持的浏览器或直接上桌面版。

⚠️ 目录里混着临时音频时,在根目录放一个 .foliaignore 排除,语法与 .gitignore 相同,重新导入后生效。更多规则见 本地音乐库管理。

跑通之后的三件值得做的事

「导入 → 播放 → 切歌 → 收藏」都通了,接着可以:

  1. 换全屏歌词动画主题,浮名、流光、群唱等风格的效果预览在 README 主题展示区;
  2. 给本地歌曲自动匹配在线歌词与封面,匹配策略和整理规则在 docs/local-library-management.md;
  3. 部署、环境变量与 Stage API 等进阶内容看 docs/technical.md。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值