登录

folia-major

chthollyphileAGPL-3.0活跃维护 有专家点评

一款支持本地音乐、Navidrome 和多个在线音乐平台的跨平台播放器，主打绚丽的歌词动画效果，适合追求视觉体验的音乐爱好者。

专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.

v0.7.27发布于 2026-11-07 10:20 UTC12,286star +316 / 7 天1,356fork同步于 2026-11-10 23:29 UTC
音乐播放器歌词动画Navidrome跨平台在线音乐
对比 GitHub 官网aimusicmusic-playernavidrome-clientplayer

专家点评

上手难度：进阶更新于 2026-11-11

把全屏歌词动画当主界面做的音乐播放器，本地库和 Navidrome 之外再挂在线源

适用场景

  • 客厅/桌面常驻播放器：歌词动画是主视觉，窗口缩放和排版参数都围绕它调，普通播放器只在小窗里滚一行字，达不到这个效果
  • 已有 Navidrome 自建库：直接当客户端用，不用再维护一套 Web 前端，本地文件与流媒体源在同一个队列里切
  • 歌词文件格式杂（lrc/vtt/ttml/qrc/yrc/krc 混着放）：同目录扫描加内嵌解析，省掉自己写转换脚本
  • 想要可改的播放页：桌面版 Folium 模组能加图层和动画，纯 Web 版做不到，需要深度定制界面时这是唯一路径

踩坑

  • 在线源接入是反复被提的方向：issue 里 Spotify、Apple Music、YouTube Music 的支持请求和 Spotify 播放报 AesKey 的 bug 同时存在，说明在线源这块可用性参差，别把它当稳定播放通道用
  • Web 版部署门槛集中在环境与安全上下文：Node >= 24 是硬要求，本地目录访问依赖可信 HTTPS，自托管要自己配反代和证书；QQ 音乐在 Vercel/Cloudflare 上还得额外配 VITE_QQ_API_BASE 和 QQ_SESSION_SECRET 并先登录
  • 模组系统只在桌面版且默认关闭，需要进设置手动开；冲着可扩展性来的话，先确认你要跑的是桌面构建而不是 Web 部署

同类对比

Navidrome 只做服务端，客户端侧可对比 Feishin、Sonixd 这类；如果核心诉求是稳定聚合多个商业流媒体源而不是歌词视觉，选成熟的 Subsonic 客户端更省事

怎么上手

由 README 提炼，执行前请确认
原文 
git clone https://github.com/chthollyphile/folia-major
npm install
npm run dev
硬件要求按 README 说明

README 未说明显存或 GPU 要求；桌面版内置前后端运行环境，Web 版需 Node.js >= 24 环境，可部署到 Vercel、Cloudflare 或 Docker。

支持 Apple Silicon有 Docker 镜像
下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

以全屏沉浸式歌词动画为核心的跨平台音乐播放器，聚合本地、Navidrome 与多平台在线音乐

一款支持本地音乐、Navidrome 和多个在线音乐平台的跨平台播放器，主打绚丽的歌词动画效果，适合追求视觉体验的音乐爱好者。

核心能力

  • 全屏歌词动画主题，可调排版参数并响应式适配窗口
  • 智能匹配在线歌词与封面，支持手动修正候选
  • 识别同目录 lrc/vtt/ttml/qrc/yrc/krc 及内嵌歌词
  • 按歌曲情绪与歌词内容 AI 生成配色主题
  • 桌面版 Folium 模组系统扩展动画与播放页图层

容易踩的坑

Web 版需 Node.js >= 24；QQ 音乐在 Vercel/Cloudflare 上需配置 VITE_QQ_API_BASE=/api/qq 与 QQ_SESSION_SECRET 且播放前必须登录；本地音乐目录访问依赖可信 HTTPS 安全上下文，自托管需配好反向代理与证书；模组系统仅桌面版可用且默认关闭，需在设置中开启。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v0.7.27
全部 release
  1. limoLimo Nightly (0.7.27-beta.1794276820)pre-release2026-11-10 · 2026-11-10 02:23 UTC
    查看更新说明

    Automated Limo nightly build for commit 185e60feeeb2b942ac818833cdfb17f020ec86d8.

    Version: 0.7.27-beta.1794276820 Source commit: https://github.com/chthollyphile/folia-major/commit/185e60feeeb2b942ac818833cdfb17f020ec86d8

  2. v0.7.27Realeco v0.7.27最新正式版2026-11-07 · 2026-11-07 10:20 UTC

    下载说明

    [!TIP] 如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Windows：下载 Folia-Setup-<version>.exe
    • macOS：
      • Apple Silicon：下载 Folia-<version>-arm64.dmg
      • Intel Mac：下载 Folia-<version>-x64.dmg
      • 如果打开时提示“应用已损坏”，这通常是当前 macOS 包未签名 / 未 notarize 导致的 Gatekeeper 拦截，不是安装包本身损坏。解决方法见这份说明

    如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Linux：
      • Arch Linux / Manjaro：通过 AUR 安装 yay -S folia-major-bin
      • Debian / Ubuntu：下载 folia-major-<version>-linux-amd64.deb
      • Fedora / openSUSE：下载 folia-major-<version>-linux-x86_64.rpm
      • 其他发行版：下载 folia-major-<version>-linux-x64.tar.gz
      • ARM64（树莓派等 aarch64 设备）：按发行版下载 folia-major-<version>-linux-arm64.deb / folia-major-<version>-linux-aarch64.rpm / folia-major-<version>-linux-arm64.tar.gz

    更新说明

    • Spotify 新增 Soloist 播放方式：拿不到音频密钥的账号（多见于 2024 年底以后注册的）现在也能听歌。登录时可以在「标准播放」和「Soloist 播放」之间选；选标准播放时，登录后会先检查这个账号能否播放，不行就提示改用 Soloist。配置清单会一步步带你装好程序、填 API 密钥、配对设备。Soloist 的声音不经过 Folia，均衡器、Automix 和视频导出对它不起作用。
    • Apple Music 改进：音量条和静音现在能控制 Apple Music 的声音；资料库多了「全部歌曲」；启动时直接显示上次的账号；桌面版窗口重建时，正在放的歌不再停下。
    • Apple Music 自带的逐字歌词不再压过你选的歌词源：如果「歌词匹配优先级」选的歌词源也有逐字歌词，就改用它。歌词设置里新增「保留平台自带的逐字歌词」开关。
    • 飞牛音乐可以在外网登录：服务器地址只填 FN ID（例如 mynas）就会经 FN Connect 中继连接，不在同一个局域网也能用。
    • 本地 .ttml 歌词里没有 itunes:key 的行不再被整行丢掉。
    • 修复酷狗打开别人的公开歌单后账号失效、取歌失败的问题。

    酷狗用户请在更新后重新登陆一次，从而清除错误的账户数据

    • 修复 Linux 上第一次播放 Spotify 时整个应用卡住的问题。
    • 速记簿的面板重新设计
    • macOS 上，思索的固定和点歌名打开平台页面改用 ⌘ 键。
    • 雾笺水族箱的聚光灯处不再白成一片，跟拍时水草只随节拍摆动。
    • Bravais 专辑海报在歌手或简介很多时不再溢出，倾斜的海报文字不再发糊。

    那些永恒的价值，正存在于这些无法复制的事物中

    What's Changed

  3. v0.7.26Realeco v0.7.262026-11-05 · 2026-11-05 15:25 UTC
    查看更新说明

    下载说明

    [!TIP] 如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Windows：下载 Folia-Setup-<version>.exe
    • macOS：
      • Apple Silicon：下载 Folia-<version>-arm64.dmg
      • Intel Mac：下载 Folia-<version>-x64.dmg
      • 如果打开时提示“应用已损坏”，这通常是当前 macOS 包未签名 / 未 notarize 导致的 Gatekeeper 拦截，不是安装包本身损坏。解决方法见这份说明

    如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Linux：
      • Arch Linux / Manjaro：通过 AUR 安装 yay -S folia-major-bin
      • Debian / Ubuntu：下载 folia-major-<version>-linux-amd64.deb
      • Fedora / openSUSE：下载 folia-major-<version>-linux-x86_64.rpm
      • 其他发行版：下载 folia-major-<version>-linux-x64.tar.gz
      • ARM64（树莓派等 aarch64 设备）：按发行版下载 folia-major-<version>-linux-arm64.deb / folia-major-<version>-linux-aarch64.rpm / folia-major-<version>-linux-arm64.tar.gz

    更新说明

    • 速记簿：从左侧滑出的歌曲暂存区（Ctrl+J）。在歌曲卡片、搜索结果、探索页和 Lattice 封面墙上悬停，就能加入速记簿或收藏到歌单。收进来的歌按来源分组，可以展开成画布摆放、框选，整组加进歌单。抽屉里还有「播放历史」和「播放队列」两页。
    • 雾笺新窗外与玻璃：窗外可以选雨夜街景、共用背景或水族箱「梦海流萤」，玻璃可以选雨窗、凝露（带萤虫）或融雪。播放页透明时，雾色跟着主题的日夜变化。命令面板加了「切换窗外」和「切换玻璃」。
    • 新平台：Apple Music（支持 macOS 14+ 与 windows 11，需要持有订阅账户；Linux 不支持）、飞牛音乐（fnOS）。
    • 跨平台队列：不同平台的歌可以排进同一个队列，切换平台不再清空播放器，退出平台时只移出它的歌。
    • 新搜索页：可以搜专辑和歌单，来源可以选已登录的平台、本地和 Navidrome。
    • 进度条胶囊：悬停时浮出常用命令，命令面板从胶囊原地长出。右侧按钮可以右键或长按原地更换，常用命令会提议放上来。新增「字幕调节」面板。
    • 推荐：网易云每日推荐新增「风格推荐」。QQ 音乐接上「猜你喜欢」电台、音乐偏好、每日 30 首的历史日期和「不喜欢」（自建后端需要 qq-music-api 3.3.6+）。网易云、酷狗、QQ 音乐的账号歌单里新增「听歌排行」。
    • 町景：支持播放页透明，切换时不再卡住，会按刷新率自动降低画质保持流畅。新增「模拟节拍」开关。
    • 全局快捷键：可以自己选修饰键和按键。点击穿透时，锁旁边多了上一首、播放暂停和下一首。
    • 歌手与专辑：歌手页新增「全部歌曲」，专辑页的歌手可以点开，Lattice 里双击磁贴直接播放。
    • 歌词：从右往左书写的歌词按正确方向排词；新增「自动 AI 分词」；搜歌词时会用上平台给的原名和歌手译名。
    • 修复：网易云在部分 IPv6 网络下请求被中断；本地多碟专辑的曲目排序不对。

    那些永恒的价值，正存在于这些无法复制的事物中

    What's Changed

  4. v0.7.25Realeco v0.7.252026-10-30 · 2026-10-30 18:38 UTC
    查看更新说明

    [!TIP] 紧急修复歌词样式「雾笺」的性能问题，其他基本与 0.7.24 相同

    下载说明

    [!TIP] 如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Windows：下载 Folia-Setup-<version>.exe
    • macOS：
      • Apple Silicon：下载 Folia-<version>-arm64.dmg
      • Intel Mac：下载 Folia-<version>-x64.dmg
      • 如果打开时提示“应用已损坏”，这通常是当前 macOS 包未签名 / 未 notarize 导致的 Gatekeeper 拦截，不是安装包本身损坏。解决方法见这份说明

    如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Linux：
      • Arch Linux / Manjaro：通过 AUR 安装 yay -S folia-major-bin
      • Debian / Ubuntu：下载 folia-major-<version>-linux-amd64.deb
      • Fedora / openSUSE：下载 folia-major-<version>-linux-x86_64.rpm
      • 其他发行版：下载 folia-major-<version>-linux-x64.tar.gz
      • ARM64（树莓派等 aarch64 设备）：按发行版下载 folia-major-<version>-linux-arm64.deb / folia-major-<version>-linux-aarch64.rpm / folia-major-<version>-linux-arm64.tar.gz

    更新说明

    Rainy Update SP1：这是 0.7.24 的热修复版本。

    • 修复歌词样式「雾笺」的性能问题：修复切换卡顿问题，播放时帧率更高、占用更低
    • 控制页的主题来源切回「默认」时，会真正换回默认主题

    以下沿用 0.7.24「Rainy Update」的内容：

    • 新增歌词样式「雾笺」：在雨夜公交车起雾的车窗上，按笔顺一笔一笔写出歌词
    • 新增三维歌词样式「町景」：日本小镇的微缩街景，歌词写在招牌上，有多种场景、时间和天气
    • 底部字幕可以排成单行、双行或三行
    • 桌面版遥控窗口可以展开播放队列
    • 更多改进：Bravais 信息条新增「自动（反向）」；「当前播放声卡」对 Web Audio 播放同样生效；汽水 VIP 和 Spotify 的提示更清楚；修复登录窗口的白屏问题

    那些永恒的价值，正存在于这些无法复制的事物中

    What's Changed

    Full Changelog: https://github.com/chthollyphile/folia-major/compare/v0.7.24...v0.7.25

  5. v0.7.24Realeco v0.7.242026-10-30 · 2026-10-30 12:49 UTC
    查看更新说明

    下载说明

    [!TIP] 如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Windows：下载 Folia-Setup-<version>.exe
    • macOS：
      • Apple Silicon：下载 Folia-<version>-arm64.dmg
      • Intel Mac：下载 Folia-<version>-x64.dmg
      • 如果打开时提示“应用已损坏”，这通常是当前 macOS 包未签名 / 未 notarize 导致的 Gatekeeper 拦截，不是安装包本身损坏。解决方法见这份说明

    如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包

    • Linux：
      • Arch Linux / Manjaro：通过 AUR 安装 yay -S folia-major-bin
      • Debian / Ubuntu：下载 folia-major-<version>-linux-amd64.deb
      • Fedora / openSUSE：下载 folia-major-<version>-linux-x86_64.rpm
      • 其他发行版：下载 folia-major-<version>-linux-x64.tar.gz
      • ARM64（树莓派等 aarch64 设备）：按发行版下载 folia-major-<version>-linux-arm64.deb / folia-major-<version>-linux-aarch64.rpm / folia-major-<version>-linux-arm64.tar.gz

    更新说明 · 0.7.24「Rainy Update」

    • 雾笺：新歌词样式，雨夜的公交车上，手指在起雾的车窗上按笔顺写下歌词，写过的地方露出窗外夜景，水珠顺着笔画淌下；可以选择手写、慢慢显现或哈气后再写，最后一句唱完会在玻璃上写出曲名和歌手。智能动感模式下，雨点跟着人声打在玻璃上，车跟着底鼓颠簸。
    • 町景：新三维歌词样式，三座微缩街景，歌词显示在 LED 大屏和招牌上；有便利店、加油站、城寨酒吧三个场景，时间和天气可以自动；可以转视角、调光圈、对焦和移轴，镜头会缓慢运镜。智能动感模式下有霓虹随拍、鼓点涟漪和大屏亮起。
    • 底部字幕行布局：可以排成单行、双行或三行，每行选当前句、下一句、翻译或罗马音，旧设置会自动转换；Lattice 展开的歌曲卡片也显示和声字幕。
    • 遥控窗口播放队列（桌面版）：展开后可以搜索，每首歌可以点播、下一首播放、移到队尾或移除。
    • Bravais 信息条方向新增「自动（反向）」。
    • 「当前播放声卡」对 Web Audio 播放同样生效，不会再从系统默认设备出声。
    • 汽水 VIP 歌和 Spotify 拿不到音频时，提示说得更准确。
    • 修复登录窗口鼠标停在平台列表最后一行时界面变空白。

    那些永恒的价值，正存在于这些无法复制的事物中

    What's Changed

    New Contributors

    Full Changelog: https://github.com/chthollyphile/folia-major/compare/v0.7.23...v0.7.24

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Folia

    Lyrics Reimagined // 辞曲新境

    简体中文 | English

    GitHub release License GitHub stars Node.js Ask DeepWiki Discord

    All Contributors

    获取方式 · Vercel 部署 · 使用指南 · 技术说明

    项目简介

    Folia是一个以全屏沉浸式歌词播放为核心的在线音乐播放器，支持网易云、酷狗、QQ 音乐、Navidrome 和本地音乐库，桌面端还支持波点音乐、YouTube Music、Spotify 和汽水音乐，通过智能歌词匹配，AI生成配色主题，以及多种全屏歌词动画为用户提供独特的听歌体验。

    提供基于Electron的 windows/ macOS/ Linux 桌面端版本与基于 Node.js 的 Web 版本，支持多平台部署。

    如果希望能够在移动设备上使用，或在浏览器上体验，可以选择一键部署到 Vercel 的 Web 版本，或自行部署到其他支持 Node.js 的平台。

    快速下载

    [!TIP]

    • GitHub：Latest Release，提供 Windows / macOS / Linux 全平台安装包。
    • 网盘：夸克网盘 · 百度云（提取码 flia），适合国内网络，仅提供 Windows 与 Apple silicon 的正式版安装包。

    更多获取方式（Web 部署、Docker、AUR、Flatpak、移动端）见下方 获取方式。

    展示

    visualizer

    演示视频

    https://github.com/user-attachments/assets/af806cf1-f67f-4b88-b2e7-57db507e9e81

    https://github.com/user-attachments/assets/fd27f4f0-64b9-4c57-8c3b-10df767f934b

    https://github.com/user-attachments/assets/704f195a-2194-434b-86e8-8f36290e5cc4

    部分主题预览

    不同的歌词动画具有不同的排版氛围和可调参数，让全屏歌词拥有如同文字PV般的丰富视觉效果，同时又能兼顾响应式布局，自动适配不同窗口尺寸。

    核心能力

    模块说明
    在线搜索与播放搜索歌曲、歌手或专辑后即可播放，并自动加载相关封面与歌词。
    本地音乐支持可导入本地音频文件，在本地安全保存索引信息，不上传文件内容。详细用法见 本地音乐库管理。
    智能歌词匹配本地歌曲可自动匹配在线歌词与封面，也支持手动修正匹配结果。
    本地歌词文件识别自动加载同目录同名 .lrc、.vtt、.ttml、.qrc、.yrc、.krc 歌词文件，或歌词文件内嵌 LRC 歌词。适配 LDDC 生成的增强型逐字歌词格式。
    Now Playing 接入支持通过本机 Now Playing 服务接入外部播放器的歌曲、时间轴与歌词信息，并驱动 Folia 的舞台视图与全屏歌词渲染。
    AI 主题生成基于歌曲情绪与歌词内容生成沉浸式背景与视觉参数。
    多端体验提供 Web 部署方式，同时支持桌面端打包分发。
    模组系统（实验性）桌面版可通过 Folium 模组添加歌词动画、背景、播放页图层、命令等，并从 模组市场 安装官方认证的模组。详见 模组系统。

    获取方式

    桌面版内置前后端运行环境，适合希望即装即用的用户。

    一键部署

    如果你希望快速上线 Web 版本，请阅读 Vercel 一键部署指南 来创建项目

    Deploy with Vercel

    项目也支持一键部署到 Cloudflare，请参考 Vercel 的部署教程进行相应调整。

    Deploy to Cloudflare

    Vercel 与 Cloudflare 上的 QQ 音乐不再需要额外部署一个常驻 API 实例：把 VITE_QQ_API_BASE 填成 /api/qq，再配一个 QQ_SESSION_SECRET（服务端密钥，不加 VITE_ 前缀）即可。这种形态支持微信扫码和手机 QQ 扫码登录（手机 QQ 扫码要 qq-music-api 3.3.3 或更高版本），且播放前必须先登录；Cloudflare 上可以再绑定一个 Durable Object，让 QQ 扫码改走长连接，并多一个 QQ 音乐 App 扫码。完整步骤、平台差异和排错方法见 QQ 音乐部署指南。

    自托管用户可以使用 Docker Compose 全栈部署。本地音乐目录访问依赖可信 HTTPS 安全上下文，部署文档包含 NAS 反向代理和证书要求。

    直接下载

    • Windows / macOS / Linux: 最新版本的安装包请前往 Releases 页面 下载。
    • Arch Linux: 可通过 AUR 获取 folia-major-bin。
    • Flatpak: 社区提供的第三方 flatpak，详情见 Flatpark。
    • Android: 社区第三方移植版见下方 移动端。

    [!IMPORTANT] 如果国内网络从 GitHub Releases 下载较慢，可以使用 夸克网盘 或 百度云 下载。网盘链接仅提供 Windows 与 Apple silicon 的正式版安装包.

    Linux 包、Wayland / Hyprland 遥控窗和桌面端细节见 技术与开发说明。

    移动端

    方式说明
    PWA（推荐）部署 Web 版本或自托管版本后，在 Chrome for Android / iOS Safari 中将网页添加到主屏幕，即可作为 PWA 应用使用。
    社区移植版（Android）maimai993/folia-sonnet · whycfawa/folia-android
    自行打包（Android）有一定技术基础的用户可以用 Capacitor 将 Web 版本打包为可安装的 APK，参考示范仓库 chthollyphile/folia-sonnet。

    [!NOTE] 社区移植版均为第三方项目，由社区自发维护，功能会与官方 PC 版存在差异。使用中遇到问题请反馈到对应的社区仓库。

    文档与开发

    更完整的使用说明请访问 Folia Guide。

    部署、环境变量、本地开发、Stage API、常用脚本和技术栈见 技术与开发说明。

    模组系统（Folium v1.x）

    [!NOTE] 模组系统是实验性功能，仅桌面版可用，默认关闭，需要在「设置 → 模组 → 模组系统」中开启。

    Folium 是 Folia 的模组平台。模组可以添加新的歌词动画模式和背景类型、在播放页上叠加内容、给进度条加按钮和标记、注册命令与设置分区、在歌词显示前改写歌词，也可以通过 Node 入口调用 ffmpeg 等本地能力。模组以可信代码运行，每个模组在启用前都要在原生窗口中确认，文件变化后需要重新确认。

    • 模组市场：folium-compound.cielaniska.top 提供官方模组和经过审查的社区模组，下载 zip 后拖进模组面板即可安装。
    • 官方认证：市场里的模组都带有 Folium 签名，安装后显示「官方认证」；只通过安全审查的先行测试模组显示「先行测试」；没有签名的第三方模组显示「未验证」，同样可以使用。
    • 开发与贡献：模组开发与贡献指南，从写第一个模组、本地调试，到提交到模组市场、审查与签名、发布更新。
    • API 参考：Folium API 参考，由契约文件生成的完整接口文档，按注册表、上下文、事件、服务等分类查询。
    • 平台规范：Folium 规范，包括清单字段、权限、注册表语义、事件、安全模型与版本策略。
    • 示范模组：仓库的 mods/ 目录，覆盖歌词动画、调参、进度条、播放页图层与透明视频导出。

    Sync Server

    Folia 提供了可选的官方同步服务端 sync-server，用于在多个设备之间同步外观设置与 AI 主题库。服务端由用户自行托管，适合希望跨设备同步配色主题的用户。

    支持以下部署方式：

    • Cloudflare Workers / D1：免服务器运维的 Serverless 部署，推荐使用。 Deploy to Cloudflare Workers
    • Docker：镜像与 Compose 入口见 Docker 部署目录。
    • Node.js 自托管：使用 SQLite，适合本地或不方便使用 Docker 的环境。

    详细的环境变量、Token 配置与部署步骤请参阅 Sync-Server 部署指南。部署完成后，在 Folia 的「设置 → 连接与集成」中填写服务端地址和 SYNC_TOKEN 即可启用同步。

    本地音乐与匹配说明

    Folia 会读取音频文件元数据、同目录歌词和封面，并可通过网易云、QQ 音乐或酷狗音乐补全歌曲信息。自动匹配按网易云、QQ、酷狗依次回退；匹配不准确时，可以手动选择候选、恢复首次导入的本地信息，或进一步合并、拆分艺术家与专辑实体。

    完整的导入、重扫、匹配、实体编辑、歌单、缓存和故障排查说明见 本地音乐库管理。

    Community

    加入discord社群，共同交流，获得帮助

    Discord

    贡献者

    感谢所有为本项目进行 Issue 提交、Bug 报告、想法建议、测试与代码编写的贡献者，均依据 all-contributors 规范进行统计

    由于列表过长，贡献记录请见 贡献者名单。

    法律与免责声明

    本项目在 AI 的广泛协助下开发，因此仍可能存在细微或不易察觉的问题。若给你带来不便，敬请理解。

    本项目主要用于展示播放动效、界面设计与相关工程实现。应用中涉及的在线音乐流媒体、歌词、专辑封面及其他内容，其版权均归对应权利人所有。

    本仓库及其源代码仅供个人学习、技术交流与非营利测试使用。请勿将其用于商业盈利用途。若因对在线资源的传播、加工或再分发而引发版权纠纷或其他责任，均由使用者自行承担，项目开发者不承担相关责任。

    请始终尊重数字版权，并在条件允许时通过官方平台支持正版音乐。

    致谢

    特别感谢以下项目和资源：

    本项目接入了 Apple Music-like Lyrics TTML 逐词歌词库 以提供高质量的歌词文件，感谢此歌词库的作者和贡献者们。

    许可证

    本项目基于 AGPL-3.0 许可证开源。

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    lx-music-desktop
    lyswhut·TypeScript

    基于 Electron 的跨平台桌面音乐播放器，聚合多源在线音乐搜索与播放，界面清爽，适合日常听歌。

    音乐播放器+4音乐播放器进阶
    55238+1067.1kv2.12.62026-11-10 04:44 UTC
    spotube
    team-spotube·Kotlin

    开源跨平台音乐播放器，桌面和手机都能用，通过 Spotify 和 YouTube 等公开来源获取歌曲，无需付费订阅即可播放。

    音乐播放器+4音乐播放器硬核
    50712+762.4kv6.0.02026-11-10 08:05 UTC
    pear-desktop
    pear-devs·TypeScript

    基于 Electron 的跨平台桌面音乐播放器，为 YouTube Music 等流媒体服务提供增强扩展，支持 Windows、macOS 和 Linux。

    音乐播放器+4音乐播放器进阶
    34017+212.0kv3.12.02026-11-08 01:55 UTC
    YesPlayMusic
    qier222·Vue

    基于 Electron 和 Vue 的第三方网易云音乐播放器，界面精致，支持 Windows、macOS、Linux 以及 PWA，让你在桌面端也能获得流畅的在线听歌体验。

    网易云音乐+4音乐播放器进阶
    33616+194.7kv0.4.112026-10-10 11:05 UTC