Folia 安装完整教程十分钟在三台设备跑起全屏歌词动画播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款基于 Electron 的全屏歌词动画播放器能播放本地曲库、Navidrome以及网易云音乐、QQ 音乐、酷狗等在线音源。跟着这份 Folia 安装教程走一遍十分钟内你就能看到带歌词动效的主界面。动手之前一眼对上你的 Folia 下载包你的设备去哪里下载拿哪个文件Windows官方网盘镜像Folia-Setup-版本.exeMacApple 芯片官方网盘镜像Folia-版本-arm64.dmgDebian、Ubuntu、Fedora 等常见 Linux仓库 Releases 便携版解压即用folia-major-版本-linux-x64.tar.gzArch LinuxAUR 包管理器构建folia-major-bin⚠️ 包只从官方入口拿网盘镜像只收录 Windows 与 Apple silicon 的正式版Linux 不在网盘里要去 Releases 列表下载。安装Windows、macOS、Linux 三条路Windows 三步装好 Folia打开 README.md在「快速下载」小节复制官方网盘链接夸克或百度均可。 → 拿到下载入口用百度盘时提取码是flia。先把文件转存到自己的网盘再下载中途断流也能续传。双击Folia-Setup-版本.exe按默认路径一路装完。 → 开始菜单里出现「Folia」图标。从开始菜单启动 Folia。 → 主窗口弹出顶部是搜索栏中间是专辑卡片墙点任意一首歌即可播放并看到全屏歌词动画。桌面版内置前后端运行环境不用再装任何依赖。macOS 拖进「应用程序」就算装完同样从 README.md「快速下载」小节复制网盘链接转存后下载。 → 拿到 macOS 的安装包。取Folia-版本-arm64.dmg文件。 → 下载完成双击打开。把 Folia 图标拖进「应用程序」文件夹。 → Launchpad 里出现 Folia。首次启动若提示已损坏或被拦截右键 Folia 图标选择「打开」。 → 细节见 docs/desktop/macos-app-damaged.md。启动后能看到带歌词动画的主界面。Linux 装 Folia便携版解压与 AUR 构建便携版解压后一条命令启动到仓库 Releases 列表下载folia-major-版本-linux-x64.tar.gz。 → 版本号与网盘镜像保持一致。放到不会被清理的固定目录解压。 → 得到含folia-major可执行文件与resources/目录的目录。直接启动./folia-major→ 终端弹出带搜索栏与专辑卡片的主窗口。想要桌面启动项复制包内模板cp resources/linux/folia-major.desktop ~/.local/share/applications/→ 再把文件里的__APP_PATH__与__ICON_PATH__两个占位符替换为真实绝对路径完整示例见 packaging/linux/README-LINUX.txt桌面环境有要求时记得把该.desktop文件标记为可信。AUR 构建Arch Linux没有 AUR Helper 先装一个yay 或 paru 都行。 → 终端里能直接调用yay或paru。执行构建安装yay -S folia-major-bin→alsa-lib、gtk3、libxss、nss会自动装好。卡在拉取 tar.gz 时先把同版本文件放进构建目录的源码目录再继续构建makepkg -si用包管理器核对结果pacman -Qs folia-major→ 输出里出现folia-major-bin条目。构建逻辑见 packaging/aur/folia-major-bin/PKGBUILD。首次启动与验收三条信号任选其一✅ 主窗口能打开看得到搜索栏与专辑卡片播放歌曲时有全屏歌词动画。✅ 便携版目录下运行./folia-major能弹出带歌词的主窗口。✅ Arch 上pacman -Qs folia-major输出里有folia-major-bin条目。卡住了怎么办Linux 黑屏、Folia 打不开这样修黑屏、透明度或模糊异常、GPU 崩溃Linux先切 swiftshader 软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-majorswiftshader 仍不稳换最保守的纯软件渲染FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major稳定后用FOLIA_LINUX_GRAPHICS_MODEsystem切回系统图形路径。便携版起不来检查folia-major可执行文件和resources/目录是否还在同一个便携包目录里缺一个都启动不了。Mac 提示「应用已损坏」右键图标选「打开」或按 docs/desktop/macos-app-damaged.md 处理。⚠️ 图形模式变量只影响 Electron 的 Linux 启动参数不改 Web 端与同步服务配置。接下来马上做把 Folia 接到真实曲库接本地音乐导入本地文件夹自动读取元数据、同目录歌词与封面见 docs/local-library-management.md。接 Navidrome 与在线音源在「设置 → 连接与集成」填服务器地址网易云、QQ 音乐、酷狗可直接接能力一览见 README.md「核心能力」。开壁纸模式在「选项 → 桌面端」开启「壁纸模式」主窗口沉到所有窗口之下当桌面歌词壁纸说明见 docs/wallpaper-mode.md。装模组在「设置 → 模组 → 模组系统」开启后把模组 zip 拖进面板即可安装规范与示范见 mods/README.md。自托管 Web 版用 Docker Compose 全栈部署见 deploy/docker/README.md。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
