★ FEATURED ARTICLE Folia 歌词动画音乐播放器全平台安装指南Windows、macOS、Linux 四条路径一次装好【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏动画的音乐播放器支持网易云、酷狗、QQ 音乐、Navidrome 和本地音乐库五种音源提供 Windows、macOS、Linux 三套桌面版。下面按系统走一遍完整安装流程每条路径都能独立走通。先定路径我的系统该走哪条安装渠道你的系统首选路径下载到的包WindowsReleases 或网盘镜像.exe安装包macOSApple siliconReleases 或网盘镜像arm64的.dmgmacOSIntel仅 Releasesx64 安装包Arch 系 LinuxAUR 或便携包folia-major-bin或linux-x64.tar.gzDebian / Ubuntu / Fedora 等便携 tar.gzlinux-x64.tar.gz记住两条网盘镜像只有 Windows 与 Apple silicon 两个包其余平台一律去仓库 Releases 页面取包网盘版本可能比最新 release 慢一拍下载前对一眼版本号。Windows下载 exe 安装包三步完成打开仓库 Releases 页面下载最新的 Windows.exe安装包外网速度太慢就去 README 的「快速下载」一节夸克网盘与百度云两条镜像都在那里百度提取码flia。双击安装器按提示完成安装。从开始菜单启动 Folia能进首页即成功。⚠️ 网盘与 Releases 装出来完全一样只是取包位置不同链接失效或版本过时以 README 里最新的镜像链接为准。macOS拖入 Applications 后一条 xattr 收尾在 Releases 页面按芯片选包Apple silicon 取arm64的 dmgIntel 取 x64 包。网盘镜像只放 Apple silicon 版Intel Mac 没有捷径直接走 Releases。挂载 dmg把Folia.app拖进Applications别在挂载盘里直接运行。首次启动被 Gatekeeper 拦下时打开终端执行xattr -dr com.apple.quarantine /Applications/Folia.app # 移除浏览器下载时附带的隔离属性⚠️ 当前 macOS 版没有 Apple Developer ID 签名与公证Gatekeeper 拦截是正常现象应用内也没有自动更新每次覆盖重装后都要再跑一次上面的命令。Linux便携包手动部署任何发行版通用在 Releases 页面下载形如folia-major-version-linux-x64.tar.gz的包解压到固定目录mkdir -p ~/Apps/Folia tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进固定目录不要换位置双击可执行文件folia-major即可启动想进应用菜单再补一步桌面项cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 把桌面项模板复制进用户应用目录打开复制出的.desktop文件替换两处占位符__APP_PATH__填folia-major可执行文件绝对路径__ICON_PATH__填resources/linux/icon.png绝对路径。桌面环境有要求时把该.desktop标记为可信。便携包里只有三样东西可执行文件、图标、桌面项模板。排查问题时先确认这三样在同一目录。Arch 系AUR 一条命令装预编译包yay -S folia-major-bin # 从 Releases 拉 linux-x64 包装进 /opt/folia-major用paru的把命令名换掉即可。包会建/usr/bin/folia-major软链接装完从应用菜单启动。⚠️ AUR 当前包版本为 0.1.4依赖alsa-lib、gtk3、libxss、nss可在 packaging/aur/folia-major-bin/PKGBUILD 逐项核对。构建本质是下载 release 的 tar.gz卡在下载步骤多是网络问题直接放弃 AUR 转上面的便携部署。启动验证与界面初印象启动后能进主界面就算装好了顶部是 Playlist / Radio / Album / Folder 标签加搜索框点进任意歌曲全屏歌词动画才是 Folia 的主场。本地库也是一等公民导入音频文件后自动读取元数据、同目录歌词与封面还能经网易云、QQ 音乐或酷狗补全歌曲信息。歌词动画有多种主题可切换排版氛围各不相同高频故障速查从隔离拦截到黑屏macOS 提示「应用已损坏」原因无签名无公证下载带上com.apple.quarantine属性Gatekeeper 显示成损坏。 解法确认跑的是Applications里的Folia.app而不是挂载盘里的临时版本再执行一次上文的 xattr 命令。Linux 黑屏、透明度异常或 GPU 崩溃原因图形路径不兼容不是装坏了。 解法强制软件渲染启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major # 软件渲染先试这一档仍不稳定就换最保守档位FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major # 最保守的软件渲染恢复系统图形路径设FOLIA_LINUX_GRAPHICS_MODEsystem。AUR 构建卡在下载步骤原因拉 release 的 tar.gz 要走外网。 解法放弃 AUR走便携包手动部署。现象解法网盘里没有 Intel Mac / Linux 的包到 Releases 页面取对应平台包macOS 提示「应用已损坏」重跑 xattr 命令移除隔离属性Linux 黑屏 / GPU 崩溃FOLIA_LINUX_GRAPHICS_MODEswiftshader启动swiftshader 下仍不稳定改用FOLIA_LINUX_GRAPHICS_MODEsoftwareAUR 卡在下载步骤转 Linux 便携版手动部署延伸阅读docs/technical.mdLinux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节packaging/linux/README-LINUX.txt便携包组成、壁纸模式与全部启动变量说明deploy/docker/README.mdDocker Compose 全栈部署 Web 版本 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
