Repolode
提交项目
jon4hz

jon4hz/jellysweep

为 Jellyfin 媒体服务器设计的智能清理工具，依据观看记录与用户请求自动清除久未观看的影视内容。

在 GitHub 查看
Star
260
Fork
22
未关闭 Issue
45
最近提交
昨天

这是什么？

Jellysweep 会读取 Jellyfin 媒体库，并按每个库单独设置的过滤条件，判断哪些电影和剧集已经不再需要。它会结合 Jellyseerr 的求片记录与 Jellystat 或 Streamystats 的观看统计，收藏内容和 Tunarr 频道正在使用的条目也可以受到保护。符合条件的内容会在 Sonarr 或 Radarr 中添加标签后标记为待删除，便于在现有工具中查看。

用户可以通过内置网页界面申请保留某些内容，管理员负责审批。相关用户可通过邮件、ntfy 或网页推送收到通知。待删除内容会经过可配置的宽限期后再真正删除，默认开启试运行模式，可以先检查将被标记的内容。

对于剧集，可以选择整部删除，或保留前 N 集、前 N 季。磁盘占用达到阈值时会自动缩短宽限期。Jellysweep 还会在 Jellyfin 中创建合集，列出即将删除的媒体。

核心功能

  • 01按媒体库设置过滤条件，可依据内容年龄、上映日期、最近观看时间和文件大小判断
  • 02通过 Sonarr 和 Radarr 的标签进行控制
  • 03磁盘占用达到阈值时缩短删除宽限期
  • 04剧集支持整部删除或保留前 N 集、前 N 季
  • 05用户可申请保留内容，管理员审批，并支持邮件、ntfy 与网页推送通知
  • 06网页界面支持 Jellyfin 登录或 OIDC/SSO 登录

适用场景

  • 家庭 Jellyfin 服务器释放存储空间，清除数月无人观看的内容
  • 让用户通过网页申请保留特定内容，同时保持媒体库整洁
  • 将长篇剧集裁剪为前几季或前几集，节省磁盘空间

快速上手

  1. 1

    创建包含 Jellysweep 服务定义的 compose.yml 文件

  2. 2

    在启动容器前创建 config.yml

    vim ./config.yml
  3. 3

    使用 Docker Compose 启动服务

    docker compose up -d

使用前须知

  • 需要能访问 Sonarr、Radarr、Jellystat 或 Streamystats 以及 Jellyseerr。
  • 由于会删除媒体文件，请务必先使用试运行模式测试。

收录于专题

家庭影音服务器自托管应用

标签

#jellyfin#media-server#cleanup#sonarr#radarr#self-hosted#disk-usage#cleanup-tool

常见问题

jellysweep 是什么？
为 Jellyfin 媒体服务器设计的智能清理工具，依据观看记录与用户请求自动清除久未观看的影视内容。 Jellysweep 会读取 Jellyfin 媒体库，并按每个库单独设置的过滤条件，判断哪些电影和剧集已经不再需要。它会结合 Jellyseerr 的求片记录与 Jellystat 或 Streamystats 的观看统计，收藏内容和 Tunarr 频道正在使用的条目也可以受到保护。符合条件的内容会在 Sonarr 或 Radarr 中添加标签后标记为待删除，便于在现有工具中查看。
jellysweep 可以免费使用吗？用的什么许可证？
jellysweep 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
jellysweep 还在维护吗？
活跃维护中。jellysweep 最近一次提交是在 2026年11月6日。
jellysweep 适合用来做什么？
家庭 Jellyfin 服务器释放存储空间，清除数月无人观看的内容 让用户通过网页申请保留特定内容，同时保持媒体库整洁 将长篇剧集裁剪为前几季或前几集，节省磁盘空间
jellysweep 怎么安装和运行？
创建包含 Jellysweep 服务定义的 compose.yml 文件 在启动容器前创建 config.yml: vim ./config.yml 使用 Docker Compose 启动服务: docker compose up -d
在哪里获取 jellysweep？
源代码和安装说明在 GitHub 上：https://github.com/jon4hz/jellysweep

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目