Folia 全屏歌词播放器安装指南5 分钟装好跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major下载条卡在 20% 一下午、装完却找不到启动项是第一次装 Folia 最容易卡住的两个地方。Foliafolia-major是一款以全屏歌词动画为核心的开源音乐播放器支持网易云、QQ 音乐、酷狗、Navidrome 和本地音乐库桌面端还内置了更多音源。Windows、macOS、Linux 都有官方桌面版下面按「最省事 → 最灵活」的顺序给出三条安装路径对号入座5 分钟装完并验证。10 秒选定你的安装路径路径适合谁操作量双击安装包直接启动Windows、macOS3 步全程不碰终端一行命令自动装好Arch Linux / Manjaro1 条命令依赖自动拉齐便携 tar.gz 解压即用其他 Linux 发行版4 步目录可整体搬家Mac 和 Windows 用户直接看路径一Arch 系跳到路径二其余 Linux 发行版走路径三其中 Debian / Ubuntu 建议直接选 Releases 里的.debFedora / RHEL / openSUSE 选.rpm按系统包管理器正常安装即可。路径一双击安装完直接启动Windows / macOS安装包都在官方 Releases 页的最新版本当前0.7.23里Windows 是Folia-Setup-0.7.23.exemacOS 苹果芯片是Folia-0.7.23-arm64.dmg、Intel 芯片是Folia-0.7.23-x64.dmg版本号有出入时以当次发布的实际文件名为准。打开仓库 README「快速下载」一节取安装包。国内网络从 Releases 直连慢的话可以换同一节里的官方网盘链接百度云提取码flia网盘提供 Windows 与 Apple silicon 正式版。 做完这步下载目录里会有一个对应系统的安装包。双击安装包。Windows 保持默认选项一路装完安装目录可以改macOS 把Folia.app拖进Applications不要直接在 dmg 挂载盘里运行。 做完这步开始菜单或 Launchpad 里会出现 Folia 图标。启动应用。 做完这步窗口应该直接打开主界面而不是弹报错。⚠️ macOS 首次启动提示「应用已损坏」当前发布没有 Apple 开发者签名这是正常拦截。在终端执行下面这行去掉下载隔离属性再从Applications重新打开xattr -dr com.apple.quarantine /Applications/Folia.app装好的第一眼应该是这个画面左上角是 Folia 标识顶部有搜索框中间是歌曲封面轮播。看到它说明安装完成。路径二一行命令装好Arch / Manjaro先确认装了 AUR helper终端里yay --version或paru --version能出版本号就行没有的话先从 AUR 装一次这是唯一的准备工作。然后跑这一条习惯 paru 就换成paru -S folia-major-bin效果相同yay -S folia-major-bin这条命令会按序装完alsa-lib、gtk3、libxss、nss等依赖。跑完后程序落在/opt/folia-major应用菜单自动生成 Folia 启动项终端里输入folia-major也能直接启动。AUR 包是从 Releases 拉 Linux 便携版重新打包的本质和路径三同一条链路它的版本号可能落后 Releases发现对不上时对照 README「快速下载」一节取新版。 AUR 构建下载慢的话先把同版本的 Linux tar.gz 下到 AUR 构建目录再执行makepkg -si可以跳过慢速下载环节。路径三便携 tar.gz 解压即用其他 Linux 发行版便携包文件名形如folia-major-0.7.23-linux-x64.tar.gz从官方 Releases 页取。建好目录并解压可执行文件folia-major和resources/会落在同一层这是正常布局mkdir -p ~/Apps/Folia tar -xzf folia-major-0.7.23-linux-x64.tar.gz -C ~/Apps/Folia先跑一次确认程序本身能起来~/Apps/Folia/folia-major做完这步主界面弹出来的话便携版就已经可用了整个目录以后放哪都行。生成应用菜单入口复制包里自带的桌面启动项模板cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/把模板里的__APP_PATH__、__ICON_PATH__两个占位符替换成实际绝对路径sed -i s|__APP_PATH__|$HOME/Apps/Folia/folia-major|;s|__ICON_PATH__|$HOME/Apps/Folia/resources/linux/icon.png| ~/.local/share/applications/folia-major.desktop做完这步应用菜单里出现 Folia 图标桌面环境有要求的话把这个.desktop标记为可信再打开。⚠️ 应用菜单里没有 Folia打开~/.local/share/applications/folia-major.desktop确认Exec、Icon两行已经变成绝对路径而不是占位符替换过仍不显示就把文件标记为可信。装完自检接一个音源30 秒确认三条路径装完后都做同一件事接一个音源——登录网易云等在线账号、连上 Navidrome或导入本地音乐库随便点开一首歌。进度条开始走动、歌词逐句铺开动画说明从音源到渲染的整条链路都通了。再挑一首有歌词的歌全屏歌词动画就是这样的效果两个容易踩的坑黑屏与壁纸模式Linux 黑屏、透明度或模糊异常GPU 渲染路径不兼容先换软件渲染启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就用最保守的软件渲染FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major想恢复系统图形路径则设为FOLIA_LINUX_GRAPHICS_MODEsystem。另外 X11含 XWayland下「智能动感模式」提示没有可用 WebGPU 时手动开 VulkanFOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11这个变量只在 X11 和系统图形路径下生效原生 Wayland 下开了反而会让 GPU 进程崩溃别开。壁纸模式桌面歌词壁纸不生效需要 Wayland 合成器支持wlr-layer-shell协议GNOME 就是不支持的典型换 niri、KWin、Hyprland 等合成器即可。这四份文档什么时候翻packaging/linux/README-LINUX.txtLinux 图形兼容开关与壁纸模式的完整说明排查渲染问题时先看它docs/technical.mdLinux 各发行版打包、Wayland 遥控窗等桌面端细节deploy/docker/README.md想用 Docker 把 Web 版自托管到手机或服务器时docs/local-library-management.md本地音乐库的导入、重扫与歌词匹配完整用法装好之后就是打开歌、看歌词跳舞的事了 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
