# JellyBox

给自建音乐库用的原生播放器，可连 Jellyfin、Emby 和 Navidrome。

> 这是 OpenNavo 上 JellyBox 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/jellybox>

- **最新版本**: `2.12.0`
- **主页**: <https://jellybox.app/>
- **分类**: [影音](https://opennavo.com/zh/categories/media)
- **安装**: `brew install --cask jellybox`
- **近 30 天安装**: 0
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://github.com/avdept/JellyBoxPlayer/releases/download/v2.12.0/JellyBox-notarized.dmg>
- **SHA-256**: `28c55573e5e8cc322fe13cb51e23a16f64b0c322b66f67a2c187a5c907ce0a82`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "JellyBox.app"
      ],
      "target": "/Applications/JellyBox.app"
    },
    "phase": "install",
    "sources": [
      "JellyBox.app"
    ],
    "target": "/Applications/JellyBox.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.prodigytech.jellybox",
            "~/Library/Caches/com.prodigytech.jellybox",
            "~/Library/HTTPStorages/com.prodigytech.jellybox",
            "~/Library/Preferences/com.prodigytech.jellybox.plist",
            "~/Library/Saved Application State/com.prodigytech.jellybox.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

JellyBox 是给自建音乐库用的原生播放器，面向在 Mac 上收听 Jellyfin、Emby 或 Navidrome 曲库的人。官方网站为 https://jellybox.app/ 。它按专辑、艺人、曲目、流派和歌单浏览，支持逐行同步歌词、离线下载，以及在设备之间移动正在播放的队列。macOS 安装包要求 macOS 12 或更高版本。价格以美国 App Store 的 JellyBox Player 页面为准，该页标为免费：https://apps.apple.com/us/app/jellybox-player/id6469732117 。

## 系统要求

- macOS 12 起 · 应用版本: 2.12.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 核查于 2026-11-21
  - <https://github.com/avdept/JellyBoxPlayer/releases/download/v2.12.0/JellyBox-notarized.dmg>
  - SHA-256: `28c55573e5e8cc322fe13cb51e23a16f64b0c322b66f67a2c187a5c907ce0a82`
- macOS 12 起 · 应用版本: 2.12.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 核查于 2026-11-21
  - <https://github.com/avdept/JellyBoxPlayer/releases/download/v2.12.0/JellyBox-notarized.dmg>
  - SHA-256: `28c55573e5e8cc322fe13cb51e23a16f64b0c322b66f67a2c187a5c907ce0a82`

## JellyBox 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/avdept/JellyBoxPlayer> · 是否开源: 是 — <https://github.com/avdept/JellyBoxPlayer> · 核查于 2026-11-21

## 卸载

- `brew uninstall --cask jellybox`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask jellybox`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/com.prodigytech.jellybox` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/com.prodigytech.jellybox` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/HTTPStorages/com.prodigytech.jellybox` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.prodigytech.jellybox.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.prodigytech.jellybox.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 3-linux (2026-03-31)

#### What's Changed
* Add playlists support by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/53
* fix(login): Trim device ID to prevent format exception by @Thogsit in https://github.com/avdept/JellyBoxPlayer/pull/76
* Bump cached_network_image from 3.3.1 to 3.4.1 by @dependabot[bot] in https://github.com/avdept/JellyBoxPlayer/pull/67
* fix(linux): Add Linux specific audio dependencies by @Thogsit in https://github.com/avdept/JellyBoxPlayer/pull/78
* fix(linux): Title bar not working by @Thogsit in https://github.com/avdept/JellyBoxPlayer/pull/80
* Bump go_router from 14.2.1 to 14.2.8 by @dependabot[bot] in https://github.com/avdept/JellyBoxPlayer/pull/88
* Bump sentry_flutter from 7.20.2 to 8.10.1 by @dependabot[bot] in https://github.com/avdept/JellyBoxPlayer/pull/96
* Make artist name on player sheet clickable by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/97
* Upgrade project for latest Flutter release, upgrade dependencies, cover pages with tests by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/116
* Add support for downloads, cover common widgets with tests by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/117
* Project refactoring by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/118
* Remove unused serverId field from DB by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/119
* Create iOS and MacOS fastlane configs by @Sv1atM in https://github.com/avdept/JellyBoxPlayer/pull/120
* Update fastfile ios by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/122
* Update version by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/123
* Show format on desktop by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/124
* Bump version by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/125
* Fixes 25.08.25 by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/121
* Automate builds by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/126
* Autosave position by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/127
* Bump build by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/128
* Fix sorting on main page by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/129
* Songs tab and other fixes by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/130
* Songs by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/131
* Linux fixes by @avdept in https://github.com/avdept/JellyBoxPlayer/pull/132

#### New Contributors
* @Thogsit made their first contribution in https://github.com/avdept/JellyBoxPlayer/pull/76

**Full Changelog**: https://github.com/avdept/JellyBoxPlayer/compare/v1.8.4...v3-linux

## 资料与来源

- <https://opennavo.com/zh/apps/jellybox>
- <https://opennavo.com/zh/apps/jellybox/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/j/jellybox.rb> · 核查于 2026-11-21
- <https://formulae.brew.sh/cask/jellybox>
- <https://github.com/avdept/JellyBoxPlayer> · 核查于 2026-11-21
