Certo, então, se você está mexendo com o Jellyfin e tentando aprimorar alguns plugins, pode ser um pouco confuso, especialmente porque o processo de instalação nem sempre é simples.Às vezes, você encontra um plugin no GitHub, copia a URL e torce para que tudo corra bem. Sim, essa é a ideia — mas sem os passos certos, você pode ficar preso ou o plugin pode não aparecer como esperado. Felizmente, o processo é bem gerenciável quando você sabe o que fazer. Este guia mostra o método usual para instalar plugins via repositórios, que é o mais comum para muitos deles. Ao final, você terá esses plugins incríveis funcionando e adicionando recursos extras à sua configuração do Jellyfin.
Como instalar plugins do Jellyfin usando URLs de repositório
Primeiros passos com URLs de repositório
Este método é provavelmente o mais fácil para a maioria dos plugins que oferecem um link JSON para o repositório. Ele se aplica quando você está instalando plugins hospedados em plataformas como o GitHub, e os autores fornecem um link que termina em ` .json.jellyfin`.Esses links são usados pelo Jellyfin para obter as informações do plugin e instalá-lo diretamente do painel de controle do servidor. Lembre-se, porém, que alguns plugins ainda exigem etapas manuais ou instruções específicas; nesse caso, é melhor consultar as páginas do GitHub deles.
Passos para adicionar plugins através de repositórios
- Após fazer login no seu servidor Jellyfin, clique no menu hambúrguer no canto superior esquerdo da página inicial — sim, o ícone com três linhas. Geralmente está bem ali, pronto para ser clicado.
- No menu, clique em “Painel de Controle”. Ele está na seção “Administração” e você deverá vê-lo com bastante clareza.
- Agora, no menu lateral, role para baixo até encontrar “Plugins”.É aí que a mágica acontece. Clique nele.
- Na tela de plugins, você verá o “Catálogo” de plugins disponíveis, mas se quiser adicionar outros, clique em “Repositórios”. Pense nessa etapa como a adição de uma nova fonte de plugins, como se estivesse adicionando uma nova loja de aplicativos.
- Em seguida, acesse a página do repositório do plugin no Github. Procure a seção que mostra as instruções de instalação. Geralmente, há um link ou um trecho de código que termina com `
.json.`.Por exemplo, algo como este — role a página até encontrar a URL JSON e copie-a (selecione o texto e Ctrl + Ccopie). - De volta ao Jellyfin, clique no ícone “+” para adicionar um novo repositório. Geralmente, esse botão fica no topo da lista de repositórios.
- Na janela pop-up, dê um nome ao repositório no campo “Nome do Repositório” — algo descritivo como “Plugin de Fanart” ou “Pular Introdução”.Em seguida, cole a URL que você copiou na caixa “URL do Repositório”. Clique em “Salvar”.
E é basicamente isso. Depois de salvar, o Jellyfin buscará as informações do plugin a partir desse URL e, se tudo correr bem, o plugin deverá aparecer na sua lista.Às vezes, leva um ou dois minutos, ou até mesmo uma reinicialização do servidor (se necessário), mas na maioria dos casos, você o verá aparecer imediatamente no Catálogo. Alguns plugins podem exigir que você habilite ou configure algumas opções posteriormente, então fique atento a isso.
Dicas extras e outras coisas que podem ajudar
Dependendo da sua configuração, se o plugin não aparecer imediatamente, tente reiniciar o servidor. Sim, é uma solução um tanto improvisada, mas ajuda o Jellyfin a recarregar todos os plugins e repositórios. Além disso, verifique se a URL que você copiou está correta — sem erros de digitação ou partes faltando. Porque, é claro, o Jellyfin tem que complicar as coisas mais do que o necessário.
E lembre-se: alguns plugins podem funcionar apenas com determinadas versões do Jellyfin, então vale a pena verificar a compatibilidade primeiro. Se você encontrar algum problema, visitar a página do plugin no Github para obter instruções específicas ou dicas de solução de problemas nunca é demais.
Aqui está uma lista de verificação rápida:
- Obtive o URL do repositório (link JSON) da página do plugin no GitHub.
- Acessei o painel de controle do Jellyfin.
- Acedi à secção Plugins e depois à secção Repositórios.
- Colei o URL e salvei.
- Aguardei um pouco ou reiniciei o servidor, se necessário.
- Verifiquei se o plugin aparecia e o ativei, se necessário.
Resumo
Instalar plugins através de URLs de repositórios não é nenhum bicho de sete cabeças, mas às vezes pode ser um pouco complicado. Depois que você pega o jeito de copiar URLs e adicioná-las na seção de Repositórios, é uma maneira simples de desbloquear vários recursos extras. Na maioria das vezes, tudo funciona bem, mas lembre-se: alguns plugins exigem instalação manual ou etapas adicionais, então não desanime se precisar de algumas tentativas. Espero que isso economize algumas horas para alguém. Tomara que ajude.