Folia 全屏歌词播放器安装教程从下载选包到首次播放一次走通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款全屏沉浸式歌词播放器支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库桌面端另可接波点音乐、YouTube Music、Spotify 与汽水音乐。这篇教程带你从挑选安装包走到安装完成、播出一首带歌词的歌预计花费 10 到 20 分钟。你只需要一个对应系统的操作系统不用预装 Node.js 或任何开发工具桌面版把运行环境都打包在了安装程序里。动手前先核对三件事下载渠道。全平台安装包都在 Releases 页面README.md的「快速下载」一节有入口。国内网络下载慢或反复中断时可以改用官方网盘镜像夸克 / 百度提取码flia。⚠️ 网盘只提供 Windows 与 Apple silicon 的正式版Intel Mac 和 Linux 包没有镜像只能走 Releases。包名与架构。当前版本是0.7.23文件命名有规律x86_64 与 ARM 的包不通用下载前逐字核对平台文件类型命名特征Windows 64 位.exe安装向导Folia-Setup-0.7.23.exemacOSApple silicon / Intel.dmg或.zipFolia-0.7.23-arm64或Folia-0.7.23-x64Linux x64.tar.gz便携包folia-major-0.7.23-linux-x64.tar.gz前置依赖。桌面版无需任何预装环境Arch 用户额外需要 yay 或 paruDocker 部署需要 Docker Engine 24 与 Compose v2。平台渠道预计耗时Windows 64 位Releases / 官方网盘约 10 分钟macOS两种芯片Releases / 官方网盘仅 arm64约 10 分钟其他 Linux 发行版Releases约 15 分钟Arch LinuxAURfolia-major-bin约 5 分钟NAS / WebDocker Compose 全栈约 20 分钟下载并核对安装包Windows在 Releases 取Folia-Setup-0.7.23.exemacOS按芯片取Folia-0.7.23-arm64.dmgApple silicon或Folia-0.7.23-x64.dmgIntel同名.zip也可以Linux取folia-major-0.7.23-linux-x64.tar.gz。走网盘的先转存到网盘再取回本地。核对文件不是 0 字节、没有被浏览器截断中途断了直接续传或重下一次。✅ 通过标准文件名里的平台与架构标识和你的机器逐字一致。安装按系统各走三步Windows双击.exe安装向导里可自选安装目录一路点下一步走完。✅ 通过标准应用列表里出现 Folia 图标。macOS打开.dmg把Folia.app拖进 Applications不要直接在挂载盘里运行。然后打开终端运行下面这条命令它移除应用的下载隔离标记执行完没有报错就是成功xattr -dr com.apple.quarantine /Applications/Folia.app✅ 通过标准从 Applications 双击能正常打开不再弹「已损坏」提示说明见 docs/desktop/macos-app-damaged.md。Arch Linux终端运行yay -S folia-major-bin它从 AUR 拉取预构建包并自动解决alsa-lib、gtk3等依赖程序落到/opt/folia-major并生成应用菜单项。✅ 通过标准应用菜单出现 Folia 入口。依赖清单可对照 PKGBUILD 核对。其他 Linux 发行版把.tar.gz解压到任意目录如~/Apps/Folia双击或运行包内的folia-major可执行文件。想给应用菜单加入口把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/把__APP_PATH__、__ICON_PATH__两个占位符替换为实际路径步骤细节见 README-LINUX.txt。✅ 通过标准命令行窗口跑起来、界面正常渲染。NAS / Web把 deploy/docker/ 里的compose.yaml与环境变量模板放进同一目录在.env里填入SYNC_TOKEN至少八位随机字符串然后运行docker compose up -d它会拉取全部服务镜像并在后台启动。✅ 通过标准浏览器打开http://NAS-IP:18080能加载页面配置细节见 deploy/docker/README.md。首次启动播一首带歌词的歌双击启动 Folia等待主界面加载。✅ 通过标准首页出现歌曲搜索框且可以正常输入。登录一个在线音源或点「Import Folder」导入一个本地音乐文件夹导入只保存索引不上传文件内容。搜索并播放一首带歌词的歌。✅ 通过标准歌词动画铺满整块屏幕、随进度推进。确认跑通了进入「关于」页面核对版本号与刚下载的包一致才算装对。 网盘镜像偶尔比 Releases 晚一拍对不上就直接重新下载。完成一次最小体验登录音源或导入本地文件夹播一首带歌词的歌确认全屏歌词动画自动亮起。进设置切两三个主题每个动画的排版氛围都不一样。遇到问题先看这里现象可能原因解法下载慢、反复中断国内到 GitHub Releases 链路差换官方网盘镜像入口以 README「快速下载」为准Linux 包没有镜像走 Releases 并开断点续传macOS 提示「Folia.app 已损坏 / 无法验证」当前版本没有 Apple Developer ID 签名和公证终端运行xattr -dr com.apple.quarantine /Applications/Folia.app移除下载隔离标记后再从 Applications 打开Linux 黑屏、透明度或模糊异常、GPU 崩溃显卡兼容问题不是装坏了先试软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳就换software值确认无碍后可再用system恢复系统图形路径启动报架构错误芯片或架构选错如 Intel Mac 拿了 arm64 包回 Releases 按系统重选一次文件名里的平台标识逐字看一遍「关于」页版本与下载的包对不上网盘镜像晚于 Releases 一拍直接重新下载 以 Releases 上的版本号为准装好后的下一步是去设置里挑一个喜欢的主题、开启「设置 → 模组」里的 Folium 模组系统默认关闭从模组市场装官方认证的歌词动画与新背景更多玩法与部署细节见 README.md 与 docs/ 目录。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/1 1:28:07 · 阅读 1.2k Folia 全屏歌词播放器安装教程：从下载选包到首次播放，一次走通
Folia 全屏歌词播放器安装教程从下载选包到首次播放一次走通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款全屏沉浸式歌词播放器支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库桌面端另可接波点音乐、YouTube Music、Spotify 与汽水音乐。这篇教程带你从挑选安装包走到安装完成、播出一首带歌词的歌预计花费 10 到 20 分钟。你只需要一个对应系统的操作系统不用预装 Node.js 或任何开发工具桌面版把运行环境都打包在了安装程序里。动手前先核对三件事下载渠道。全平台安装包都在 Releases 页面README.md的「快速下载」一节有入口。国内网络下载慢或反复中断时可以改用官方网盘镜像夸克 / 百度提取码flia。⚠️ 网盘只提供 Windows 与 Apple silicon 的正式版Intel Mac 和 Linux 包没有镜像只能走 Releases。包名与架构。当前版本是0.7.23文件命名有规律x86_64 与 ARM 的包不通用下载前逐字核对平台文件类型命名特征Windows 64 位.exe安装向导Folia-Setup-0.7.23.exemacOSApple silicon / Intel.dmg或.zipFolia-0.7.23-arm64或Folia-0.7.23-x64Linux x64.tar.gz便携包folia-major-0.7.23-linux-x64.tar.gz前置依赖。桌面版无需任何预装环境Arch 用户额外需要 yay 或 paruDocker 部署需要 Docker Engine 24 与 Compose v2。平台渠道预计耗时Windows 64 位Releases / 官方网盘约 10 分钟macOS两种芯片Releases / 官方网盘仅 arm64约 10 分钟其他 Linux 发行版Releases约 15 分钟Arch LinuxAURfolia-major-bin约 5 分钟NAS / WebDocker Compose 全栈约 20 分钟下载并核对安装包Windows在 Releases 取Folia-Setup-0.7.23.exemacOS按芯片取Folia-0.7.23-arm64.dmgApple silicon或Folia-0.7.23-x64.dmgIntel同名.zip也可以Linux取folia-major-0.7.23-linux-x64.tar.gz。走网盘的先转存到网盘再取回本地。核对文件不是 0 字节、没有被浏览器截断中途断了直接续传或重下一次。✅ 通过标准文件名里的平台与架构标识和你的机器逐字一致。安装按系统各走三步Windows双击.exe安装向导里可自选安装目录一路点下一步走完。✅ 通过标准应用列表里出现 Folia 图标。macOS打开.dmg把Folia.app拖进 Applications不要直接在挂载盘里运行。然后打开终端运行下面这条命令它移除应用的下载隔离标记执行完没有报错就是成功xattr -dr com.apple.quarantine /Applications/Folia.app✅ 通过标准从 Applications 双击能正常打开不再弹「已损坏」提示说明见 docs/desktop/macos-app-damaged.md。Arch Linux终端运行yay -S folia-major-bin它从 AUR 拉取预构建包并自动解决alsa-lib、gtk3等依赖程序落到/opt/folia-major并生成应用菜单项。✅ 通过标准应用菜单出现 Folia 入口。依赖清单可对照 PKGBUILD 核对。其他 Linux 发行版把.tar.gz解压到任意目录如~/Apps/Folia双击或运行包内的folia-major可执行文件。想给应用菜单加入口把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/把__APP_PATH__、__ICON_PATH__两个占位符替换为实际路径步骤细节见 README-LINUX.txt。✅ 通过标准命令行窗口跑起来、界面正常渲染。NAS / Web把 deploy/docker/ 里的compose.yaml与环境变量模板放进同一目录在.env里填入SYNC_TOKEN至少八位随机字符串然后运行docker compose up -d它会拉取全部服务镜像并在后台启动。✅ 通过标准浏览器打开http://NAS-IP:18080能加载页面配置细节见 deploy/docker/README.md。首次启动播一首带歌词的歌双击启动 Folia等待主界面加载。✅ 通过标准首页出现歌曲搜索框且可以正常输入。登录一个在线音源或点「Import Folder」导入一个本地音乐文件夹导入只保存索引不上传文件内容。搜索并播放一首带歌词的歌。✅ 通过标准歌词动画铺满整块屏幕、随进度推进。确认跑通了进入「关于」页面核对版本号与刚下载的包一致才算装对。 网盘镜像偶尔比 Releases 晚一拍对不上就直接重新下载。完成一次最小体验登录音源或导入本地文件夹播一首带歌词的歌确认全屏歌词动画自动亮起。进设置切两三个主题每个动画的排版氛围都不一样。遇到问题先看这里现象可能原因解法下载慢、反复中断国内到 GitHub Releases 链路差换官方网盘镜像入口以 README「快速下载」为准Linux 包没有镜像走 Releases 并开断点续传macOS 提示「Folia.app 已损坏 / 无法验证」当前版本没有 Apple Developer ID 签名和公证终端运行xattr -dr com.apple.quarantine /Applications/Folia.app移除下载隔离标记后再从 Applications 打开Linux 黑屏、透明度或模糊异常、GPU 崩溃显卡兼容问题不是装坏了先试软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳就换software值确认无碍后可再用system恢复系统图形路径启动报架构错误芯片或架构选错如 Intel Mac 拿了 arm64 包回 Releases 按系统重选一次文件名里的平台标识逐字看一遍「关于」页版本与下载的包对不上网盘镜像晚于 Releases 一拍直接重新下载 以 Releases 上的版本号为准装好后的下一步是去设置里挑一个喜欢的主题、开启「设置 → 模组」里的 Folium 模组系统默认关闭从模组市场装官方认证的歌词动画与新背景更多玩法与部署细节见 README.md 与 docs/ 目录。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考