jon4hz/jellysweep

O que é?

Recursos principais

• 01Filtros por biblioteca com base na idade do conteúdo, data de lançamento, horário da última reprodução e tamanho
• 02Controle por tags pelo Sonarr e pelo Radarr
• 03Limites de uso de disco que encurtam o período de carência antes da exclusão
• 04Modos seletivos de limpeza de séries de TV que mantêm os primeiros N episódios ou temporadas
• 05Solicitações dos usuários para manter conteúdos, com aprovação de administradores e notificações por e-mail, ntfy ou web push
• 06Autenticação do Jellyfin ou login OIDC/SSO na interface web

Casos de uso

• Liberar espaço em um servidor Jellyfin doméstico removendo conteúdos que ninguém assiste há meses
• Manter uma biblioteca do Jellyfin organizada e permitir que os usuários solicitem exceções pela interface web
• Reduzir séries longas de TV às temporadas ou aos episódios iniciais para economizar espaço

Início rápido

1. 1

   Crie um arquivo compose.yml com a definição do serviço Jellysweep

2. 2

   Crie config.yml antes de iniciar o contêiner

   vim ./config.yml
3. 3

   Inicie o serviço com o Docker Compose

   docker compose up -d

Antes de usar

• !É necessário ter acesso ao Sonarr, Radarr, Jellystat ou Streamystats e Jellyseerr.
• !Como ele exclui arquivos de mídia, sempre teste primeiro com o modo dry-run.

Em coleções

Tópicos

Perguntas frequentes

O que é jellysweep?

Ferramenta inteligente para limpar o Jellyfin, identificando e removendo filmes e séries antigos e não assistidos com base no histórico de visualização e em solicitações dos usuários. O Jellysweep analisa sua biblioteca do Jellyfin e, usando filtros definidos por biblioteca, decide quais filmes e séries não são mais necessários. Ele consulta o Jellyseerr para verificar solicitações e o Jellystat ou o Streamystats para consultar o histórico de visualização. Também pode proteger favoritos e itens usados por canais do Tunarr. Os itens elegíveis são marcados para exclusão com tags no Sonarr ou no Radarr, mantendo o processo visível nas ferramentas que você já usa.

jellysweep é gratuito? Qual é a licença?

jellysweep é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

jellysweep ainda é mantido?

Manutenção ativa. O último commit de jellysweep foi em 6 de nov. de 2026.

Para que posso usar jellysweep?

Liberar espaço em um servidor Jellyfin doméstico removendo conteúdos que ninguém assiste há meses Manter uma biblioteca do Jellyfin organizada e permitir que os usuários solicitem exceções pela interface web Reduzir séries longas de TV às temporadas ou aos episódios iniciais para economizar espaço

Como instalar jellysweep?

Crie um arquivo compose.yml com a definição do serviço Jellysweep Crie config.yml antes de iniciar o contêiner: vim ./config.yml Inicie o serviço com o Docker Compose: docker compose up -d

Onde consigo jellysweep?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jon4hz/jellysweep