如何在 Mac 上卸载 Jellyfin Media Player

Jellyfin Media Player 只是个客户端，电影、剧集和音乐都在你的 Jellyfin 服务器上，从这台 Mac 上删掉应用不会碰它们，也不会碰你在服务器上的账号。它在本地留的是配置，包括你为调播放效果自己写的 mpv.conf，另外是缓存和日志，手写过 mpv.conf 的话，删应用之前先把它拷到稳妥的地方。这份指南覆盖从项目 GitHub Releases 下载的 Jellyfin Media Player 1.12.0 和 Homebrew cask jellyfin-media-player，两者装的都是 Jellyfin Media Player.app，bundle ID 是 tv.jellyfin.player。

先看装的是哪个 Jellyfin 客户端

这个项目后来改名叫 Jellyfin Desktop，新版本把数据放在另外的文件夹里，配置在 ~/Library/Application Support/Jellyfin Desktop/profiles/<profile-id>/，Caches 和 Logs 下也是对应的 Jellyfin Desktop 文件夹，见 Jellyfin Desktop 的 README。你的应用叫 Jellyfin Desktop 的话去那几个文件夹里找，这份指南剩下的内容讲的是测试过的 Jellyfin Media Player.app。

退出应用，移除它

  1. 停止播放，从菜单退出 Jellyfin Media Player。
  2. 在活动监视器里确认没有 Jellyfin Media Player 进程了。
  3. 把「应用程序」里的 Jellyfin Media Player.app 移到废纸篓。

Jellyfin Media Player 的数据放在哪里

位置 里面是什么 如何处理
~/Library/Application Support/Jellyfin Media Player 配置，包括 jellyfinmediaplayer.conf、可选的 mpv.conf 和应用的其他本地数据，之前一次测试打开后 795 KB 自己写过 mpv.conf 就先备份，不再用这个应用时删掉文件夹
~/Library/Logs/Jellyfin Media Player 应用日志 随应用一起删
~/Library/Caches/Jellyfin Media Player 应用缓存 随应用一起删

配置和日志的位置来自 1.12.0 版的 README，缓存文件夹是实测看到的，Homebrew 的 zap 清单里也有。

检查结果

应用进了废纸篓之后，运行下面两条只读命令：

pgrep -lf "Jellyfin Media Player.app"
ls -d "$HOME/Library/Application Support/Jellyfin Media Player" "$HOME/Library/Application Support/Jellyfin Desktop"
  • pgrep 没有输出，说明应用没在运行，列出进程说明它还开着。
  • ls -d 会打印还在的文件夹，不在的报「No such file or directory」，用 Mole 按默认勾选卸载后，Jellyfin Media Player 还在是正常的，打印出 Jellyfin Desktop 说明这台 Mac 上也用过改名后的新客户端。

用 Homebrew 安装时

Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。

jellyfin-media-player 这个 cask 的 zap 清单包括 ~/Library/Application Support/Jellyfin Media Player、~/Library/Caches/Jellyfin Media Player、~/Library/Logs/Jellyfin Media Player、一个名为 org.jellyfin.Jellyfin Media Player.plist 的偏好设置文件，以及 tv.jellyfin.player 的窗口状态，自己运行 brew uninstall --cask --zap jellyfin-media-player 会把它们连同 mpv.conf 一起移到废纸篓，不看 Mole 里勾了什么。只移除应用：

brew uninstall --cask jellyfin-media-player

Homebrew 的 jellyfin-media-player cask

Mole 会列出什么

对从 GitHub 下载的 Jellyfin Media Player：

  • ~/Library/Application Support/Jellyfin Media Player 会列出，但默认不勾选，里面是你的配置。
  • ~/Library/Caches/Jellyfin Media Player、~/Library/Logs/Jellyfin Media Player 和 tv.jellyfin.player 下的临时缓存默认勾选。
  • Jellyfin 服务器上的媒体从来不会列出。

这次检查覆盖了什么

2026 年 9 月 26 日，从 GitHub Releases 下载 Apple 芯片版 1.12.0 装好，再用开发版 Mole 把列出的每一行都勾上卸载。第一次打开停在了 macOS 对网上下载的应用弹出的确认框上，清掉之后重跑，这次只起了主进程，约 32 MB，小到进不了 Mole 状态页导出的那几行，这么短的一次运行也没有写出数据文件夹，所以卸载时只列出了应用本身，它进了废纸篓。9 月 21 日用同一来源的同一版本测过一次，那次走得更完整，应用起了两个进程，自己和它的网页引擎，把列出的每一行都勾上之后，应用、795 KB 的 Application Support 文件夹、缓存、日志、偏好设置和临时缓存都进了废纸篓。两次都没有出现登录项或后台任务，也都没有连接服务器，保存的服务器和登录都没有测到。