folia-major 安装与首次跑通指南30 分钟点亮全屏歌词动画【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia仓库名 folia-major是一款以全屏沉浸式歌词动画为核心的音乐播放器本地音乐文件夹、Navidrome、网易云 / 酷狗 / QQ 音乐在线平台都能放把歌词渲染成全屏动画。支持 Windows / macOS / Linux 桌面端与 Web 版当前正式版0.7.23。跟着下文拿包、装上、接上音源就能跑通。动手前清单系统、安装包、音源系统Windows、macOSApple silicon或 Linux x86-64 桌面安装包到项目官方 Releases 页选对应平台包当前版本号0.7.23文件名里的数字要对得上音源三选一至少备齐一种本地音乐文件夹支持 MP3、FLAC、M4A、WAV、OGG、Opus、AAC网易云 / 酷狗 / QQ 音乐账号桌面版另支持波点音乐、YouTube Music、Spotify 等自托管的 Navidrome 服务 没有在线账号就先备本地音乐首次跑通走这条最稳。Folia 0.7.23 安装步骤Windows、macOS、Linux 三条路WindowsReleases 里选Folia-Setup-0.7.23.exe双击安装包跟着向导点到底成功标志开始菜单里出现 Folia启动后主窗口正常出来。macOSApple silicon 选Folia-0.7.23-arm64.dmgIntel 选 x64 包打开 dmg把Folia.app拖进Applications别在挂载盘里直接运行成功标志启动台里能看到 Folia。⚠️ 当前版本未做 Apple 公证首次打开可能被拦成已损坏 / 无法验证见下文故障排查。Linux选folia-major-0.7.23-linux-x64.tar.gz也有 deb / rpm解压tar -xzf folia-major-0.7.23-linux-x64.tar.gz包内是folia-major可执行文件、resources/linux/icon.png和桌面启动模板resources/linux/folia-major.desktop。要建桌面启动项把模板复制到~/.local/share/applications/再把其中的__APP_PATH__、__ICON_PATH__换成实际绝对路径直接跑./folia-major成功标志窗口出不黑屏能看到首页的歌单区与搜索框。首次跑通接上音源让全屏歌词亮出来本地音乐路线进入首页的本地音乐区域点导入文件夹选中音乐目录。Folia 递归扫描读取元数据与同目录同名歌词文件.lrc、.vtt等扫完歌曲卡片上墙。在线平台路线在账号入口登录网易云、酷狗或 QQ 音乐搜索一首歌点播放。Navidrome 路线在 Navidrome 入口填服务器地址NAS 上的曲库直接可播。三条路线的成功标志都一样主窗口不黑屏、能看到首页点播放后歌词亮出全屏动画且正常出声。全屏歌词动画有多种排版风格可切换下面这种就是其中之一。 歌词没对上时先查同目录.lrc文件是否与音频同名track.lrc或track.mp3.lrc都认。故障排查黑屏、被拦、版本对不上现象Linux 启动黑屏、透明度/模糊异常或 GPU 崩溃原因GPU 图形路径冲突Linux 上最常见。解法FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就把取值换成software。这些变量只影响 Electron 的 Linux 启动参数Wayland 与壁纸模式细节见 packaging/linux/README-LINUX.txt。现象macOS 弹Folia.app 已损坏或Apple 无法验证原因当前版本未接入 Apple Developer ID 签名与 notarizationGatekeeper 拦截了下载隔离属性包本身没坏。解法终端执行xattr -dr com.apple.quarantine /Applications/Folia.app再从Applications重新打开。⚠️ macOS 版不支持应用内自动更新每次覆盖安装新版本后隔离属性会重新带上这条命令要再跑一次。仍打不开的进一步处理见 docs/desktop/macos-app-damaged.md。现象网盘镜像里的版本号和 Releases 对不上原因镜像可能滞后一个版本。解法以 Releases 页版本号为准直接取最新包核对文件名里的0.7.23。其它安装入口AUR、Docker 自托管、PWAArch 系yay -S folia-major-bin一条命令装进/opt/folia-major并生成启动项。代价是构建时要拉一次 Release 包下载慢会卡住——手动把folia-major-0.7.23-linux-x64.tar.gz放进构建目录再跑makepkg -si。Web / 自托管想在手机、平板上听或部署到 NAS看仓库deploy/docker/目录下的 Docker 全栈部署文档要求 Docker Engine 24Web 默认端口 18080起服务后在浏览器把网页装成 PWA。代价服务要自己托管。包装好、音源接上全屏歌词动画已经在你屏幕上了。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考