Folia 全屏歌词动画播放器下载与安装教程Windows / macOS / Linux 完整跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 把歌词渲染成全屏动画支持网易云、酷狗、QQ 音乐、Navidrome 等在线音源和本地音乐库并提供 Windows / macOS / Linux 桌面版。下面按「查环境 → 挑安装包 → 分平台装」三步走最后用首次启动的首页帮你确认装没装好。先花一分钟对一下环境这节解决的是「我的电脑到底行不行、该用哪条下载链路」的问题先对完再动手能少绕很多弯路。系统桌面版覆盖 Windows、macOS、Linux 三大平台桌面端内置前后端运行环境装完即用不需要额外装 Node.js 之类的前置依赖。芯片macOS 的安装包按芯片区分——Apple siliconM 系列对应arm64Intel 对应x64Linux 包是 x86_64 架构先确认自己的机器不是 ARM。网络能直连 GitHub Releases 的话所有平台都能从 Releases 页面直接下载国内网络偏慢时Windows 与 Apple silicon 可以改用网盘镜像。版本基准本文涉及的版本号以仓库当前版本 0.7.22 为准文件名里的version都按你实际拿到的版本替换。挑对安装包这节帮你把三种安装包对号入座同样是 Folia包装形式不同适合的人不一样。图形安装包双击安装Windows 是Folia-Setup-version.exe安装向导支持自选安装目录也提供中文界面macOS 是Folia-version-arm64.dmg或Folia-version-x64.dmg。适合所有想把步骤控制在「双击 → 下一步」的用户。来源有两个GitHub Releases 的最新 release或网盘镜像仅 Windows 与 Apple silicon 两种正式版百度云提取码flia两条网盘链接都放在 README 的「快速下载」一节里。命令行包终端装Arch 系走 AUR 包folia-major-bin一条命令装完同一份 release 里还有.deb和.rpm分别对应 apt / dnf 系发行版的包管理器。适合习惯用终端管理软件、希望装进系统目录的用户。便携包解压即用Linux 的folia-major-version-linux-x64.tar.gz没有安装程序解压完就能跑。适合 Debian、Ubuntu、Fedora 等非 Arch 系发行版也适合希望整个程序住在一个可移动目录里的场景。分平台实操这节把上面的选择落成具体操作按你的系统直接跳到对应小节。Windows 安装步骤国内网络的 Windows 用户或者直连速度还可以的用户都可以看这节——两条下载链路都能落地。先拿到安装器国内网络优先看 README「快速下载」一节的夸克 / 百度云链接百度提取码flia能直连就打开 Releases 页面两条路拿到的都是Folia-Setup-version.exe。双击安装器按向导提示点完安装目录可以改装完后开始菜单会多出一个 Folia 条目。从开始菜单打开 Folia能进首页就算这一步完成验收标准见下一大节。坑点提醒网盘镜像只收录 Windows 与 Apple silicon 两种包而且版本可能比最新 release 滞后下载前先对一眼版本号对不上就以 Releases 的最新版本为准。macOS 安装步骤与 Gatekeeper 放行macOS 用户先看芯片再选包装完大概率还要做一步放行这节两步都讲清楚。打开「关于本机」确认芯片是 Apple silicon 还是 Intel再去对应渠道下载Apple silicon 拿Folia-version-arm64.dmg国内网络走网盘即可Intel 只能拿Folia-version-x64.dmg网盘里没有 Intel 包要去 Releases 页面找。挂载 dmg 后把Folia.app从挂载窗口拖进「应用程序」文件夹别在挂载盘里直接点运行。双击启动时如果弹出「Folia.app 已损坏」或「无法验证」打开终端执行下面这行作用是移除下载隔离属性执行完再回「应用程序」里重新打开xattr -dr com.apple.quarantine /Applications/Folia.app坑点提醒当前发布的 macOS 版没有 Apple Developer ID 签名与公证首次启动被 Gatekeeper 拦是预期行为这个版本也不支持应用内自动更新以后每次手动重装新版本都要把上面的xattr命令再执行一遍。原理和备选方案详见 docs/desktop/macos-app-damaged.md。Arch 系安装AUR 一条命令装 folia-major-bin已装好 yay 或 paru 的 Arch / Arch 系用户看这节全程不需要碰安装包。终端敲yay --version确认 AUR 助手可用paru 用户确认paru --version。执行yay -S folia-major-binparu 用户把命令名换成paru构建时它会从 Releases 下载 linux-x64 的 tar.gz把程序装进/opt/folia-major并在/usr/bin/folia-major建好软链接和桌面入口。装完在终端直接敲folia-major试跑一次没问题就关终端从应用菜单启动 Folia。坑点提醒AUR 包目前固定构建 0.1.4 版本可在packaging/aur/folia-major-bin/PKGBUILD的pkgver里核对依赖alsa-lib、gtk3、libxss、nss四个库构建如果卡在下载 tar.gz 那一步多半是网络原因不必纠结直接改用下一节的便携包手动部署。Linux 通用发行版安装便携包手动部署Debian、Ubuntu、Fedora 这类非 Arch 系发行版或者想把整套程序放在一个便携目录里的用户按这节的五步走。到 Releases 页面下载folia-major-version-linux-x64.tar.gz同一份 release 里也有.deb和.rpm对应发行版可以直接用包管理器装但便携包的通用性最好。建一个固定目录并解压进去mkdir -p ~/Apps/Folia tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia这样整套程序就落在~/Apps/Folia以后升级、迁移都只动这一个目录。 3. 把便携包自带的桌面项模板复制到用户级应用目录cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/复制出来的文件才是你真正要编辑的对象原模板不用动。 4. 用文本编辑器打开~/.local/share/applications/folia-major.desktop把两个占位符换成真实路径__APP_PATH__填folia-major可执行文件的绝对路径__ICON_PATH__填resources/linux/icon.png的绝对路径。 5. 桌面环境有要求时比如 KDE 首次会提示把该.desktop文件标记为可信然后从应用菜单启动 Folia。坑点提醒便携包一共三样东西——folia-major可执行文件、resources/linux/icon.png和桌面项模板排查任何启动问题前先确认可执行文件与resources/目录位于同一便携包内。导入本地文件夹后歌曲会出现在 Folder 标签页下装好没冒烟验收这节给一套跨平台统一的判定标准不管你怎么装的按这三步对一遍就知道结果。✅看入口Windows 的开始菜单、macOS 的「应用程序」、Linux 的应用菜单里都应该出现 Folia 条目。打开应用看首页顶部有 Playlists / Radio / Albums / Folder 这一排标签页右上角有搜索框左上角是 Folia 标识——能看到这些说明前端正常加载了。搜一首歌点播放全屏歌词动画出现就算完全装好。如果用的是 Navidrome 这类自建源记得先在设置里填好服务地址配好后的主页长这样如果 Linux 上启动后出现黑屏、透明度 / 模糊异常甚至 GPU 直接崩溃多半是图形路径的问题而不是装坏了。在终端给启动命令加一个环境变量强制改用 swiftshader 软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major这个档位下仍不稳定的话把变量值改成software即最保守的软件渲染档位问题确认后也可以设回system恢复系统图形路径。各模式的完整说明在 packaging/linux/README-LINUX.txt 里。装不上就看这这节把高频故障写成「症状 → 定位 → 动作」的短条目对号入座即可。⚠️症状macOS 首次打开提示「Folia.app 已损坏」或「无法验证」。定位版本没有 Developer ID 签名与公证dmg 下载后带上了com.apple.quarantine隔离属性。动作执行xattr -dr com.apple.quarantine /Applications/Folia.app然后从「应用程序」重新打开。症状Linux 启动后黑屏、透明度 / 模糊异常或 GPU 崩溃。定位系统图形路径与渲染不兼容程序本体是好的。动作用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major启动还不稳就改用FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major。症状AUR 构建卡住长时间停在下载 tar.gz 的步骤。定位到 Releases 的网络链路不稳定。动作放弃 AUR 这条线改走便携包手动部署几分钟内能落地。症状应用菜单里没有 Folia 图标桌面快捷方式也不显示。定位.desktop文件的Exec/Icon还是占位符或文件没被标记为可信。动作把两个占位符替换成绝对路径再按桌面环境的提示标记可信。症状网盘里翻不到自己平台的包比如 Intel Mac 或 Linux。定位网盘镜像只收录 Windows 与 Apple silicon 两种正式版安装包。动作回到 Releases 页面下载对应平台的包。下一步装好之后这几篇仓库内文档值得接着看正好覆盖日常使用最常见的三个方向docs/technical.mdLinux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节遇到渲染问题先翻这里。deploy/docker/README.mdDocker Compose 全栈部署 Web 版本的完整流程适合想在 NAS 或服务器上跑一份的场景。docs/local-library-management.md本地音乐库的导入、匹配、歌单与故障排查本地库用户必读。packaging/linux/README-LINUX.txtFOLIA_LINUX_GRAPHICS_MODE等全部图形相关环境变量与壁纸模式说明。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/29 10:18:42 · 阅读 1.2k Folia 全屏歌词动画播放器下载与安装教程：Windows / macOS / Linux 完整跑通
Folia 全屏歌词动画播放器下载与安装教程Windows / macOS / Linux 完整跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 把歌词渲染成全屏动画支持网易云、酷狗、QQ 音乐、Navidrome 等在线音源和本地音乐库并提供 Windows / macOS / Linux 桌面版。下面按「查环境 → 挑安装包 → 分平台装」三步走最后用首次启动的首页帮你确认装没装好。先花一分钟对一下环境这节解决的是「我的电脑到底行不行、该用哪条下载链路」的问题先对完再动手能少绕很多弯路。系统桌面版覆盖 Windows、macOS、Linux 三大平台桌面端内置前后端运行环境装完即用不需要额外装 Node.js 之类的前置依赖。芯片macOS 的安装包按芯片区分——Apple siliconM 系列对应arm64Intel 对应x64Linux 包是 x86_64 架构先确认自己的机器不是 ARM。网络能直连 GitHub Releases 的话所有平台都能从 Releases 页面直接下载国内网络偏慢时Windows 与 Apple silicon 可以改用网盘镜像。版本基准本文涉及的版本号以仓库当前版本 0.7.22 为准文件名里的version都按你实际拿到的版本替换。挑对安装包这节帮你把三种安装包对号入座同样是 Folia包装形式不同适合的人不一样。图形安装包双击安装Windows 是Folia-Setup-version.exe安装向导支持自选安装目录也提供中文界面macOS 是Folia-version-arm64.dmg或Folia-version-x64.dmg。适合所有想把步骤控制在「双击 → 下一步」的用户。来源有两个GitHub Releases 的最新 release或网盘镜像仅 Windows 与 Apple silicon 两种正式版百度云提取码flia两条网盘链接都放在 README 的「快速下载」一节里。命令行包终端装Arch 系走 AUR 包folia-major-bin一条命令装完同一份 release 里还有.deb和.rpm分别对应 apt / dnf 系发行版的包管理器。适合习惯用终端管理软件、希望装进系统目录的用户。便携包解压即用Linux 的folia-major-version-linux-x64.tar.gz没有安装程序解压完就能跑。适合 Debian、Ubuntu、Fedora 等非 Arch 系发行版也适合希望整个程序住在一个可移动目录里的场景。分平台实操这节把上面的选择落成具体操作按你的系统直接跳到对应小节。Windows 安装步骤国内网络的 Windows 用户或者直连速度还可以的用户都可以看这节——两条下载链路都能落地。先拿到安装器国内网络优先看 README「快速下载」一节的夸克 / 百度云链接百度提取码flia能直连就打开 Releases 页面两条路拿到的都是Folia-Setup-version.exe。双击安装器按向导提示点完安装目录可以改装完后开始菜单会多出一个 Folia 条目。从开始菜单打开 Folia能进首页就算这一步完成验收标准见下一大节。坑点提醒网盘镜像只收录 Windows 与 Apple silicon 两种包而且版本可能比最新 release 滞后下载前先对一眼版本号对不上就以 Releases 的最新版本为准。macOS 安装步骤与 Gatekeeper 放行macOS 用户先看芯片再选包装完大概率还要做一步放行这节两步都讲清楚。打开「关于本机」确认芯片是 Apple silicon 还是 Intel再去对应渠道下载Apple silicon 拿Folia-version-arm64.dmg国内网络走网盘即可Intel 只能拿Folia-version-x64.dmg网盘里没有 Intel 包要去 Releases 页面找。挂载 dmg 后把Folia.app从挂载窗口拖进「应用程序」文件夹别在挂载盘里直接点运行。双击启动时如果弹出「Folia.app 已损坏」或「无法验证」打开终端执行下面这行作用是移除下载隔离属性执行完再回「应用程序」里重新打开xattr -dr com.apple.quarantine /Applications/Folia.app坑点提醒当前发布的 macOS 版没有 Apple Developer ID 签名与公证首次启动被 Gatekeeper 拦是预期行为这个版本也不支持应用内自动更新以后每次手动重装新版本都要把上面的xattr命令再执行一遍。原理和备选方案详见 docs/desktop/macos-app-damaged.md。Arch 系安装AUR 一条命令装 folia-major-bin已装好 yay 或 paru 的 Arch / Arch 系用户看这节全程不需要碰安装包。终端敲yay --version确认 AUR 助手可用paru 用户确认paru --version。执行yay -S folia-major-binparu 用户把命令名换成paru构建时它会从 Releases 下载 linux-x64 的 tar.gz把程序装进/opt/folia-major并在/usr/bin/folia-major建好软链接和桌面入口。装完在终端直接敲folia-major试跑一次没问题就关终端从应用菜单启动 Folia。坑点提醒AUR 包目前固定构建 0.1.4 版本可在packaging/aur/folia-major-bin/PKGBUILD的pkgver里核对依赖alsa-lib、gtk3、libxss、nss四个库构建如果卡在下载 tar.gz 那一步多半是网络原因不必纠结直接改用下一节的便携包手动部署。Linux 通用发行版安装便携包手动部署Debian、Ubuntu、Fedora 这类非 Arch 系发行版或者想把整套程序放在一个便携目录里的用户按这节的五步走。到 Releases 页面下载folia-major-version-linux-x64.tar.gz同一份 release 里也有.deb和.rpm对应发行版可以直接用包管理器装但便携包的通用性最好。建一个固定目录并解压进去mkdir -p ~/Apps/Folia tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia这样整套程序就落在~/Apps/Folia以后升级、迁移都只动这一个目录。 3. 把便携包自带的桌面项模板复制到用户级应用目录cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/复制出来的文件才是你真正要编辑的对象原模板不用动。 4. 用文本编辑器打开~/.local/share/applications/folia-major.desktop把两个占位符换成真实路径__APP_PATH__填folia-major可执行文件的绝对路径__ICON_PATH__填resources/linux/icon.png的绝对路径。 5. 桌面环境有要求时比如 KDE 首次会提示把该.desktop文件标记为可信然后从应用菜单启动 Folia。坑点提醒便携包一共三样东西——folia-major可执行文件、resources/linux/icon.png和桌面项模板排查任何启动问题前先确认可执行文件与resources/目录位于同一便携包内。导入本地文件夹后歌曲会出现在 Folder 标签页下装好没冒烟验收这节给一套跨平台统一的判定标准不管你怎么装的按这三步对一遍就知道结果。✅看入口Windows 的开始菜单、macOS 的「应用程序」、Linux 的应用菜单里都应该出现 Folia 条目。打开应用看首页顶部有 Playlists / Radio / Albums / Folder 这一排标签页右上角有搜索框左上角是 Folia 标识——能看到这些说明前端正常加载了。搜一首歌点播放全屏歌词动画出现就算完全装好。如果用的是 Navidrome 这类自建源记得先在设置里填好服务地址配好后的主页长这样如果 Linux 上启动后出现黑屏、透明度 / 模糊异常甚至 GPU 直接崩溃多半是图形路径的问题而不是装坏了。在终端给启动命令加一个环境变量强制改用 swiftshader 软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major这个档位下仍不稳定的话把变量值改成software即最保守的软件渲染档位问题确认后也可以设回system恢复系统图形路径。各模式的完整说明在 packaging/linux/README-LINUX.txt 里。装不上就看这这节把高频故障写成「症状 → 定位 → 动作」的短条目对号入座即可。⚠️症状macOS 首次打开提示「Folia.app 已损坏」或「无法验证」。定位版本没有 Developer ID 签名与公证dmg 下载后带上了com.apple.quarantine隔离属性。动作执行xattr -dr com.apple.quarantine /Applications/Folia.app然后从「应用程序」重新打开。症状Linux 启动后黑屏、透明度 / 模糊异常或 GPU 崩溃。定位系统图形路径与渲染不兼容程序本体是好的。动作用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major启动还不稳就改用FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major。症状AUR 构建卡住长时间停在下载 tar.gz 的步骤。定位到 Releases 的网络链路不稳定。动作放弃 AUR 这条线改走便携包手动部署几分钟内能落地。症状应用菜单里没有 Folia 图标桌面快捷方式也不显示。定位.desktop文件的Exec/Icon还是占位符或文件没被标记为可信。动作把两个占位符替换成绝对路径再按桌面环境的提示标记可信。症状网盘里翻不到自己平台的包比如 Intel Mac 或 Linux。定位网盘镜像只收录 Windows 与 Apple silicon 两种正式版安装包。动作回到 Releases 页面下载对应平台的包。下一步装好之后这几篇仓库内文档值得接着看正好覆盖日常使用最常见的三个方向docs/technical.mdLinux 图形模式、Wayland / Hyprland 遥控窗等桌面端细节遇到渲染问题先翻这里。deploy/docker/README.mdDocker Compose 全栈部署 Web 版本的完整流程适合想在 NAS 或服务器上跑一份的场景。docs/local-library-management.md本地音乐库的导入、匹配、歌单与故障排查本地库用户必读。packaging/linux/README-LINUX.txtFOLIA_LINUX_GRAPHICS_MODE等全部图形相关环境变量与壁纸模式说明。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考