Folia 安装下载教程：Windows、macOS、Linux 五条路线，十分钟装好

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是以全屏歌词动画为核心的音乐播放器，支持本地音乐库、Navidrome、网易云等在线音源。下载页直连不畅、不知道选哪个包？三大平台的 5 条 Folia 安装路线都在这。

装完你手里有什么

• Windows：桌面与开始菜单出现 Folia 快捷方式，双击即开
• macOS：「应用程序」与启动台里出现 Folia.app
• Linux 原生包 / AUR：应用菜单出现 folia-major 入口，终端注册了folia-major命令
• Linux 便携版：解压目录里有一个可执行二进制，运行即弹主窗口
• 任意平台：添加本地音乐目录或登录在线音源后，播放任意歌曲，全屏歌词动画铺满屏幕

30 秒判断该走哪条路

1. 如果你是 Windows → 走网盘镜像，下Folia-Setup-<版本>.exe安装包双击即可。
2. 如果你是 macOS → 也走网盘镜像，先在「关于本机」看芯片：Apple M 系选arm64，Intel 选x64。
3. 如果你是 Arch / Manjaro → 走 AUR，一条命令构建安装一步到位。
4. 如果你是 Ubuntu / Linux Mint 等 Debian 系 → 去 Releases 下.deb原生包，一条dpkg命令装好。
5. 如果你是 Fedora / openSUSE 等 RPM 系 → 下.rpm原生包，一条dnf命令装好。
6. 如果你是其他 Linux 发行版 → 用tar.gz便携版兜底，解压即用。

网盘镜像（夸克 / 百度，提取码flia）只提供 Windows 版与 Apple 芯片 macOS 版，版本可能落后最新一档，拿不准就以 Releases 页面的版本号为准。

Windows：网盘下一条 → 双击装好

⚠️ 前置条件：能打开网盘分享链接，入口在项目 README 的「快速下载」一节。

1. 先把分享转存到自己网盘再下载Folia-Setup-<版本>.exe，分享直连容易限速。
2. 双击exe走安装向导一路下一步，默认位置或自选目录都可以。

桌面和开始菜单出现快捷方式、双击弹出主窗口不报错，这步就算对了。网盘版本落后最新一档也没关系，直接从 Releases 下新exe覆盖安装，不用卸载。

macOS：网盘下一条 → 拖进应用程序装好

⚠️ 前置条件：先在「关于本机」确认芯片型号，M 系下Folia-<版本>-arm64.dmg，Intel 下x64后缀包。

1. 从网盘分享（提取码flia）下载对应dmg，双击挂载出安装窗口。
2. 把窗口里的Folia.app拖进「应用程序」。不要直接从挂载窗口运行，弹出镜像后正在运行的应用会立刻崩溃。

「应用程序」和启动台里出现 Folia.app、双击不报错，这步就算对了。首次打开若弹「已损坏 / 无法验证」提示，不是包坏了，处理办法见报错速查。

Arch / Manjaro：AUR 一条命令 → 构建装好依赖自动补齐

⚠️ 前置条件：先确认 AUR 助手yay（或paru）已装，执行yay --version能打印版本号即就绪。

1. 执行安装命令，助手自动从 Releases 拉同版本tar.gz包完成构建安装，构建规则见 PKGBUILD 文件：

   yay -S folia-major-bin

2. 依赖alsa-lib、gtk3、libxss、nss四个包由助手自动处理，不用手动装。

构建结束提示包已安装，应用菜单里folia-major能弹出主窗口，这步就算对了。

Debian 系：dpkg 一条命令 → 原生安装带菜单项

1. 从 Releases 页面下载folia-major-<版本>-linux-x64.deb。
2. 执行sudo dpkg -i folia-major-*.deb，dpkg 只负责解包注册，不管依赖。
3. 若提示缺依赖，再执行sudo apt -f install让 apt 自动补齐。

应用菜单出现 folia-major 入口且双击能启动，这步就算对了。

Fedora / RPM 系：dnf 一条命令 → 原生安装依赖自动补齐

1. 从 Releases 页面下载folia-major-<版本>-linux-x64.rpm。
2. 执行sudo dnf install ./folia-major-*.rpm，dnf 会顺带解析并安装依赖。

应用菜单出现入口且能正常启动，这步就算对了。

其他 Linux 发行版：tar.gz 解压一条 → 便携版直接跑

1. 从 Releases 页面下载folia-major-<版本>-linux-x64.tar.gz，解压到固定目录，比如~/Apps/Folia/。
2. 在解压目录里执行~/Apps/Folia/folia-major，主窗口弹出即说明可用。

⚠️ 可执行文件必须和resources/目录留在同一解压目录，拆开放会找不到资源直接启动失败。

主窗口弹出且不黑屏，这步就算对了。想加菜单项：把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把__APP_PATH__、__ICON_PATH__两个占位符替换成实际绝对路径，模板说明见 Linux 便携版文档。

验证安装是否成功

各平台肉眼可判的信号：

• Windows：桌面与开始菜单出现快捷方式，双击能正常启动
• macOS：启动台或「应用程序」里能看到 Folia，打开不报错
• Linux：应用菜单出现 folia-major；便携版则是终端跑二进制不报错、主窗口正常弹出而非黑屏

终极验证是放一首歌：添加本地音乐目录或登录在线音源，点开任意歌曲播放，看全屏歌词动画随节奏渲染出来。

AUR 路线可以再加一条命令行终验：

which folia-major

预期打印/usr/bin/folia-major。Debian 系用dpkg -s folia-major看状态是否为install ok installed，RPM 系用rpm -q folia-major看是否打印版本号。

报错速查

以上都没命中的话，带「Folia + 报错关键词」去项目官方 Issues 搜一遍，或直接把终端输出贴进去提 Issue。macOS 细节可对照 macOS 损坏提示处理。

全屏歌词动画才是 Folia 的全部卖点，路线选对装完，放首歌试试 🎵

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major