Repolode
Maintainerr

Maintainerr/Maintainerr

Ferramenta para manutenção de bibliotecas do Plex, Jellyfin e Emby, que usa regras para reunir mídias não assistidas ou não solicitadas e removê-las após um período de carência.

Estrelas
2,355
Forks
126
Issues abertas
3
Último commit
ontem

O que é?

Maintainerr automatiza a limpeza de uma biblioteca de mídia. Você cria regras com base em propriedades como atividade de reprodução, solicitações e idade, combinadas com lógica AND/OR. Os títulos que correspondem às regras são reunidos em uma coleção, ficam disponíveis por um período de carência configurável para que as pessoas possam assisti-los e, depois, recebem uma ação. Entre as ações estão excluir arquivos do disco, desmonitorar ou excluir itens no Radarr, Sonarr ou Sportarr, alterar perfis de qualidade e limpar solicitações no Seerr ou Ombi.

Os itens são identificados no servidor de mídia e nos apps *arr por IDs do IMDB, TMDB e TVDB, com verificação do ano de lançamento para evitar ações sobre o título errado. As coleções podem ser gerenciadas automaticamente ou manualmente, e as regras podem ser executadas em uma agenda cron. As notificações são enviadas por serviços como Discord, Slack, Telegram, ntfy e email.

Maintainerr pode ser implantado com Docker, Podman ou Kubernetes e oferece uma interface Swagger/OpenAPI e endpoints de saúde.

Recursos principais

  • 01Criador de regras que usa propriedades do Plex, Jellyfin, Emby, Radarr, Sonarr, Seerr, Ombi e Tautulli.
  • 02Período de carência antes da remoção, com a opção de exibir as coleções na tela inicial do Plex.
  • 03Exclui arquivos do disco e executa ações sobre itens do Radarr, Sonarr e Sportarr.
  • 04Sobreposições em pôsteres e pôsteres personalizados para coleções.
  • 05Importação/exportação de regras em YAML e migração entre servidores.
  • 06Notificações por Discord, Slack, Telegram, ntfy, email e webhooks.

Casos de uso

  • Liberar espaço em disco removendo filmes e séries que ninguém assiste há muito tempo.
  • Limpar solicitações antigas de mídia no Seerr ou Ombi depois que o título for removido.
  • Avisar com antecedência os membros da casa por meio de uma coleção “Saindo em breve” antes da exclusão.
  • Executar instâncias separadas para servidores de mídia diferentes, com regras isoladas.

Início rápido

  1. 1

    Instale o Docker

  2. 2

    Inicie o Maintainerr com Docker run

    docker run -d --name maintainerr -e TZ=Europe/Brussels -v ./data:/opt/data -u 1000:1000 -p 6246:6246 --restart unless-stopped ghcr.io/maintainerr/maintainerr:latest
  3. 3

    Abra a interface web na porta 6246 e conecte seu servidor de mídia

Antes de usar

  • A mídia é excluída automaticamente após um período de carência, por isso é preciso configurar as regras com cuidado.
  • Sobreposições de imagem e pôsteres de coleções precisam de uma CPU compatível com x86-64-v2 em sistemas x86.

Em coleções

Tópicos

Perguntas frequentes

O que é Maintainerr?
Ferramenta para manutenção de bibliotecas do Plex, Jellyfin e Emby, que usa regras para reunir mídias não assistidas ou não solicitadas e removê-las após um período de carência. Maintainerr automatiza a limpeza de uma biblioteca de mídia. Você cria regras com base em propriedades como atividade de reprodução, solicitações e idade, combinadas com lógica AND/OR. Os títulos que correspondem às regras são reunidos em uma coleção, ficam disponíveis por um período de carência configurável para que as pessoas possam assisti-los e, depois, recebem uma ação. Entre as ações estão excluir arquivos do disco, desmonitorar ou excluir itens no Radarr, Sonarr ou Sportarr, alterar perfis de qualidade e limpar solicitações no Seerr ou Ombi.
Maintainerr é gratuito? Qual é a licença?
Maintainerr é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Maintainerr ainda é mantido?
Manutenção ativa. O último commit de Maintainerr foi em 23 de out. de 2026.
Para que posso usar Maintainerr?
Liberar espaço em disco removendo filmes e séries que ninguém assiste há muito tempo. Limpar solicitações antigas de mídia no Seerr ou Ombi depois que o título for removido. Avisar com antecedência os membros da casa por meio de uma coleção “Saindo em breve” antes da exclusão. Executar instâncias separadas para servidores de mídia diferentes, com regras isoladas.
Como instalar Maintainerr?
Instale o Docker Inicie o Maintainerr com Docker run: docker run -d --name maintainerr -e TZ=Europe/Brussels -v ./data:/opt/data -u 1000:1000 -p 6246:6246 --restart unless-stopped ghcr.io/maintainerr/maintainerr:latest Abra a interface web na porta 6246 e conecte seu servidor de mídia
Onde consigo Maintainerr?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Maintainerr/Maintainerr

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados