PosterPilot

O PosterPilot é um aplicativo web auto-hospedado que navega por uma biblioteca de mídia (Plex, Jellyfin ou Emby — um ativo por vez), encontra capas de artwork em vários provedores e aplica a capa escolhida ao seu servidor de mídia — diretamente via sua API e/ou exportando YAML compatível com Kometa/PMM. Ele roda como um único contêiner Docker em um Mac ou em um servidor Unraid.

Um assistente guiado de primeira instalação leva você desde a escolha de um idioma até a conexão do seu servidor, a chave do TMDB e os provedores, a escolha de bibliotecas e uma primeira sincronização — e, para o Plex, inclui um login por PIN e a descoberta de conexões para que você nunca precise caçar um token ou uma URL.

O que ele faz

Sincronize sua biblioteca

Sincronize suas bibliotecas de filmes e séries e resolva cada título para um id do TMDB para que os provedores de artwork possam ser consultados com precisão.

Encontre capas

Distribua a busca entre os provedores habilitados — MediUX, Fanart.tv, TMDB e ThePosterDB — e compare candidatos de pôster e de fundo agrupados por provedor e conjunto. Use um conjunto inteiro, misture peças entre provedores ou monte um conjunto personalizado a partir de uma URL colada ou um arquivo enviado.

Aplique capas

Aplique a capa escolhida via API do servidor de mídia (envia e bloqueia o campo, instantaneamente) e/ou via uma exportação YAML do Kometa que a sua instância do Kometa consome na próxima execução.

Mantenha-se localizado

A interface vem em inglês, espanhol, chinês simplificado, japonês e português do Brasil, com fallback para o inglês por chave — gerenciada pelo Weblate.

O trabalho em toda a biblioteca roda como jobs em segundo plano com progresso ao vivo via Server-Sent Events, exibido diretamente no Dashboard. Um log granular de Atividade (Configurações → Atividade) e um log de arquivo rotativo registram cada evento operacional, e um verificador de atualizações com um modal “Novidades” apresenta os novos releases.

Para onde ir a seguir

Instalação Execute o PosterPilot com Docker Compose em um Mac ou no Unraid usando a imagem oficial do GHCR.

Configuração Conecte um servidor de mídia, defina sua chave do TMDB, habilite provedores de artwork e conheça a referência completa de variáveis de ambiente.

Uso Sincronize uma biblioteca, encontre capas, aplique-as, monte conjuntos personalizados e filtre o mural da biblioteca.

Contribuindo Configure o projeto localmente e execute os portões de qualidade antes de enviar uma alteração.

Stack

• SvelteKit (TypeScript) sobre Bun, construído com adapter-node
• SQLite + Drizzle ORM (libsql) para o cache da biblioteca, candidatos, histórico, jobs e configurações
• Tailwind CSS v4, uma interface escura e centrada em imagens
• Uma fila de jobs em processo com Server-Sent Events para progresso ao vivo

O PosterPilot é distribuído sob a Licença MIT.