JellyBox：Jellyfin/Emby 跨平台音乐播放器

项目简介

JellyBox 是面向 Jellyfin、Emby 和 Navidrome 的音乐客户端（Navidrome 使用 OpenSubsonic 兼容接口）。它专注一件事：把你自己音乐服务器上的曲库，做成现代流媒体 App 的体验——快速浏览、离线下载与渐进式缓存、歌词、类 Spotify 的日常歌单，并且为每个平台单独设计界面，而不是一套布局硬拉到所有设备。

JellyBox 是客户端，不是服务端。使用前你需要一个已运行、且已建立音乐库的 Jellyfin、Emby 或 Navidrome 服务器。

项目基于 Flutter/Dart 开发，以 AGPL-3.0 协议开源。

主要功能

曲库与浏览

• 连接 Jellyfin、Emby 或 Navidrome，可在多个服务器之间切换而无需重新登录
• Jellyfin Quick Connect：手机或桌面端免密登录
• 浏览专辑、艺术家、流派、歌单与歌曲，支持多音乐库
• 全局搜索，也可只筛选歌单、专辑、艺术家或歌曲
• 艺术家页含简介与完整作品列表；收藏曲目会同步回服务器
• 在应用任意位置创建歌单、添加曲目
• 首页展示最近播放、最近添加与个性化混音，并按常听流派生成流派混音

播放

• 播放记忆：重启后恢复队列与播放位置
• 时间同步歌词浮层
• 队列管理：随机播放、循环，以及随机的「surprise me」队列
• 按连接配置流媒体档位，遇到不支持的编码自动转码；显示音质标识
• 手机横屏播放布局；支持 ListenBrainz 记录收听

离线

• 专辑与单曲下载，支持完全离线模式，飞行途中也能听已下载内容

外观

• 根据当前专辑封面生成配色方案
• Studio Mode：全屏动画播放界面

桌面与系统集成

• 媒体键与全局快捷键
• Linux MPRIS，兼容 GNOME/KDE 媒体组件与 playerctl
• Windows 系统媒体浮层（封面与播放控制）
• macOS 与 iOS 上的 AirPlay 及系统输出切换
• 投放到 DLNA / UPnP 设备（智能电视、网络音箱、功放）
• iOS / Android 锁屏与通知控制
• Apple CarPlay 与 Android Auto（均为 beta）

安装与使用

可从 Releases 获取各平台安装包：

Linux Flatpak 安装：

flatpak install ./jellybox-linux-x86_64.flatpak

其他发行包依赖若干共享库，Debian/Ubuntu 上可先安装：

sudo apt-get install libmpv-dev mpv libasound2-dev libsecret-1-dev libsqlite3-dev libjsoncpp-dev libcurl4-openssl-dev libdbus-1-dev

从源码构建需要 Flutter 与 Dart SDK 3.8+，以及目标平台工具链：

flutter pub get
flutter run

若修改了模型、DTO 或 API 客户端，需要执行 dart run build_runner build --delete-conflicting-outputs 重新生成代码。

注意事项

• macOS 默认不允许应用读取媒体键，首次使用时需在「系统设置 → 隐私与安全性 → 辅助功能」中勾选 JellyBox；若列表中没有，用 + 手动添加。
• Windows 安装包未签名，首次运行会出现 SmartScreen 提示，选择「更多信息 → 立即运行」即可；便携 zip 解压后可直接运行。
• Android 侧载 APK 时，需要在浏览器或文件管理器中允许安装未知来源应用。
• Linux 的 Flatpak 包自带依赖库，但仍建议在不同发行版上测试后再长期使用。
• CarPlay 与 Android Auto 支持目前处于 beta 阶段。

本作品整理自 GitHub 开源项目 avdept/JellyBoxPlayer，原作者 @avdept，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。