
O Jellyfin Ă© um servidor de mĂdia gratuito e de cĂłdigo aberto que coloca sua biblioteca de mĂdia no centro: vocĂȘ estĂĄ no comando, vocĂȘ decide o que compartilhar e como reproduzir. Sem contas obrigatĂłrias, taxas premium ou telemetria invasiva; a filosofia Ă© clara: "sua mĂdia, do seu jeito", com total privacidade e controle em casa ou na sua rede.
Neste guia prĂĄtico e completo, vocĂȘ descobrirĂĄ o que Ă© o Jellyfin, sua histĂłria e licença, plataformas e clientes compatĂveis, recursos principais como TV ao vivo, SyncPlay ou DLNA, uma visĂŁo geral do processo de instalação e configuração (incluindo Docker e NAS), diferenças reais em comparação com o Plex e o Emby, versĂ”es com novos recursos como Dolby Vision ou AV1, alĂ©m de detalhes para desenvolvedores (.NET, ffmpeg, clientes web e API) e experiĂȘncias de usuĂĄrios com problemas comuns e suas soluçÔes.
O que Ă© Jellyfin e por que Ă© importante
O Jellyfin Ă© um conjunto de aplicativos e um servidor de mĂdia projetado para organizar, gerenciar e compartilhar seus arquivos digitais (vĂdeo, ĂĄudio, fotos e atĂ© mesmo ebooks EPUB) usando um modelo cliente-servidor. O servidor Ă© instalado em Linux, Windows, macOS ou em um contĂȘiner Docker, e os clientes sĂŁo executados em celulares, tablets, Smart TVs, reprodutores de mĂdia, consoles de jogos ou diretamente em um navegador da web.
Ao contrĂĄrio de alternativas proprietĂĄrias como Plex ou Emby, o Jellyfin Ă© um software 100% livre (GPLv2), sem assinaturas, recursos pagos ou autenticação de terceiros. Ele funciona perfeitamente em uma intranet isolada, sem depender de serviços externos, e pode transmitir conteĂșdo para dispositivos DLNA e Chromecast em sua rede.
História, Licença e Filosofia da Jellyfin
O projeto nasceu em 8 de dezembro de 2018, como um fork do Emby , quando a comunidade (com cofundadores como Andrew Rabert e Joshua Boniface) reagiu ao encerramento do seu desenvolvimento de código aberto. O primeiro lançamento ocorreu em 30 de dezembro de 2018 e, a partir de janeiro de 2019, adotou seu próprio sistema de versionamento, começando com a versão 10.0.0, com atualizaçÔes constantes.
A licença GPLv2 garante que o cĂłdigo permaneça livre e que a comunidade possa auditĂĄ-lo, aprimorĂĄ-lo e redistribuĂ-lo, uma abordagem que tambĂ©m se traduz em privacidade: nĂŁo hĂĄ "segundas intençÔes", nenhum rastreamento e nenhuma conta obrigatĂłria para usar sua prĂłpria mĂdia, algo que muitos usuĂĄrios valorizam em comparação com os modelos freemium.
Plataformas, ecossistema e clientes
O Jellyfin Ă© verdadeiramente multiplataforma : servidor para Linux, Windows, macOS e Docker; clientes para Android, iOS e iPadOS, Amazon Fire TV, Android TV e Fire TV, Roku, Xbox One e Series X/S, TVs LG com webOS, aplicativos para desktop (Jellyfin Media Player) e uma interface web acessĂvel pelo navegador.
Existem também complementos e plugins para integração com o Kodi e até mesmo compatibilidade não oficial com versÔes anteriores de clientes Emby em alguns casos (embora isso esteja se tornando menos comum à medida que o código diverge). Por padrão, o acesso utiliza HTTP na porta 8096 e HTTPS na porta 8920, o que facilita o acesso local e remoto com a configuração apropriada.
Principais recursos que fazem a diferença
- TV ao vivo e gravação: Se vocĂȘ adicionar o hardware/serviços necessĂĄrios, o Jellyfin pode sintonizar TV ao vivo e gerenciar gravaçÔes, sem limites de canais impostos por licenças de terceiros.
- Chromecast e DLNA: VocĂȘ pode transmitir conteĂșdo para dispositivos Chromecast e transmitir conteĂșdo para players compatĂveis com DLNA. A partir do Jellyfin 10.9, o DLNA passou a ser gerenciado como um plugin, mantendo a funcionalidade, mas movendo-a para a seção de Complementos.
- Sincronizar Play:Desde a versĂŁo 10.6.0, vĂĄrios usuĂĄrios podem visualizar o mesmo conteĂșdo de forma sincronizada, ideal para sessĂ”es remotas de grupo.
- EPUB eBooks e segmentos de mĂdia- Adicionada leitura de EPUB e, em versĂ”es recentes, melhorias como segmentos de mĂdia (por exemplo, capĂtulos em arquivos de vĂdeo) para navegação mais precisa.
- Sem paywalls: Transcodificação, scrapers personalizados, reprodução de playlists de IPTV (via Xteve ou HDHomeRun) e outros recursos avançados estĂŁo disponĂveis sem assinaturas.
Aplicativo oficial para Android e experiĂȘncia mĂłvel
O aplicativo oficial para Android Ă© o complemento natural para o servidor : vocĂȘ precisa ter um servidor Jellyfin em execução e, a partir do aplicativo, pode reproduzir sua biblioteca, enviar conteĂșdo para o Chromecast, visualizar sua coleção com uma interface amigĂĄvel e ouvir mĂșsica com o Android Auto (somente online).
O lema âSua mĂdia, em seus termosâ faz sentido em dispositivos mĂłveis : sem contas ou rastreamento, com acesso direto Ă sua coleção e suporte robusto para reprodução local quando o formato for compatĂvel, minimizando a transcodificação desnecessĂĄria.
Instalação e primeiros passos (PC, Docker e NAS)
A configuração Ă© cliente-servidor : primeiro vocĂȘ instala o servidor e depois conecta um ou mais clientes. O site oficial oferece instaladores para Linux, Windows, macOS e Docker, e a comunidade mantĂ©m pacotes para diversos dispositivos NAS.
QNAP NAS e um atalho prĂĄtico : alguns usuĂĄrios instalam o Jellyfin no QNAP usando um arquivo .qpkg (por exemplo, o do pdulvp no GitHub) diretamente da Central de Aplicativos, acelerando a implantação com um Ăcone e inicialização como qualquer outro aplicativo NAS.
Tenha cuidado com a porta 8096 se estiver usando o Emby : o Jellyfin e o Emby usam a porta 8096 por padrĂŁo, entĂŁo, se estiverem rodando na mesma mĂĄquina, vocĂȘ provavelmente verĂĄ o servidor Emby ao abrir o Jellyfin. Altere a porta de um deles para evitar o conflito.
Assistente de configuração inicial : Ao iniciar o servidor Jellyfin, escolha seu idioma, crie um usuĂĄrio (Ă© melhor evitar "admin" e usar uma senha forte) e defina suas bibliotecas indicando se sĂŁo filmes, sĂ©ries, mĂșsicas etc., o idioma dos metadados e seu paĂs para classificaçÔes corretas.
Acesso externo e portas : Inicialmente, Ă© melhor desativar o acesso externo e a abertura automĂĄtica de portas; depois que tudo estiver funcionando corretamente, vocĂȘ pode considerar expor as portas 8096/8920 somente se necessĂĄrio e com as medidas de segurança apropriadas.
Organização de arquivos e scrapers: seja organizado
O Jellyfin recompensa a organização com menos surpresas : ao contrårio do Plex, que "tolera" nomes caóticos, o Jellyfin funciona muito melhor com convençÔes de nomenclatura claras, especialmente para séries. Uma estrutura como "Série/Temporada 2/Série S02E01.mp4" evita problemas e agiliza a identificação.
Se necessĂĄrio, renomeie; caso contrĂĄrio, personalize : embora renomear possa ser tedioso, o Jellyfin permite que vocĂȘ use scrapers personalizados e edite metadados manualmente sem pagar, algo que outras plataformas escondem atrĂĄs de seus planos premium.
Desempenho, transcodificação e qualidade de reprodução
A reprodução local Ă© ĂĄgil e robusta : quem migra do Plex costuma notar carregamentos iniciais mais leves e menos buffering quando o formato Ă© compatĂvel, evitando transcodificação desnecessĂĄria.
A transcodificação é gratuita, mas consome recursos : se o seu NAS ou servidor for modesto, a transcodificação em tempo real pode sobrecarregå-lo. Ative a aceleração de hardware em Reprodução > Conversão e experimente HEVC e AV1, se o seu hardware permitir, ajustando as suas expectativas de acordo com o seu sistema.
Plugins, IPTV e ecossistema de extensÔes
O repositório oficial de complementos oferece componentes essenciais : DLNA (agora como um plugin), integraçÔes com Infuse e Kodi, NextPVR, Trakt e muito mais. Não é um catålogo infinito, mas cobre o båsico, e a comunidade contribui com repositórios de terceiros sem precisar estar no oficial.
Listas IPTV gratuitas : O Jellyfin pode reproduzir IPTV usando o Xteve ou o HDHomeRun como intermediårios; a configuração requer um pouco mais de trabalho do que no Kodi, mas uma vez que o fluxo esteja configurado, ele se integra muito bem à sua biblioteca.
Segurança e privacidade
Sem contas forçadas, sem telemetria e sem terceiros : o Jellyfin nĂŁo envia seus dados para servidores externos e pode operar dentro da sua rede sem exposição pĂșblica. Mesmo assim, use senhas fortes e pense bem se vocĂȘ realmente precisa abrir portas para o mundo exterior.
FĂłruns e redes com "muros de cookies" : Recursos da comunidade, como o Reddit, podem exibir avisos sobre cookies e tecnologias semelhantes; isso nĂŁo faz parte do Jellyfin, mas vale a pena ter em mente se vocĂȘ consultar tĂłpicos de suporte nessas plataformas.
Desenvolvimento: Compilando, Contribuindo e Depurando o Jellyfin
O repositĂłrio do servidor estĂĄ no GitHub e utiliza .NET (atualmente, o SDK 9.0 Ă© necessĂĄrio para compilar). VocĂȘ tambĂ©m precisa do ffmpeg e pode desenvolver com o Visual Studio 2022 ou o VS Code em qualquer sistema operacional principal (exceto FreeBSD, que ainda nĂŁo Ă© suportado).
Cliente web separado do backend : O servidor fornece arquivos estĂĄticos para o cliente web por padrĂŁo, mas esses arquivos nĂŁo estĂŁo incluĂdos no repositĂłrio. VocĂȘ pode obtĂȘ-los de trĂȘs maneiras: baixando builds concluĂdos do pipeline do Azure DevOps, compilando-os a partir do repositĂłrio jellyfin-web ou copiando-os de uma instalação de servidor existente.
Primeiros passos e depuração : No Visual Studio, abra a solução e pressione F5. No VS Code, abra a pasta do repositório, instale as extensÔes recomendadas e pressione F5. Na linha de comando, digite "dotnet run" ou compile e execute o binårio (./jellyfin no Linux/macOS ou jellyfin.exe no Windows).
Para hospedar o cliente web separadamente : use a flag â--nowebclientâ ou a variĂĄvel âJELLYFIN_NOWEBCONTENT=trueâ. Existe um perfil de inicialização chamado âJellyfin.Server(nowebcontent)â. Observe que o assistente de configuração nĂŁo pode ser executado se o cliente web estiver separado.
API e testes : A documentação da API reside em â/api-docs/swagger/index.htmlâ na porta do servidor. Os testes unitĂĄrios sĂŁo executados usando âdotnet testâ e fazem parte do pipeline de CI no Azure.
Codespaces e contĂȘineres de desenvolvimento : Ao criar o ambiente, o carregamento das extensĂ”es pode levar de 20 a 30 segundos (.NET 7.x nos logs). Se vocĂȘ estiver acessando de fora, marque as portas como pĂșblicas. A tela de login pode aparecer no primeiro acesso; recarregue a pĂĄgina para ser redirecionado ao assistente. Existem variaçÔes do contĂȘiner "nowebclient" e uma com o ffmpeg6 prĂ©-instalado (inicializador "ghcs .NET Launch (nowebclient, ffmpeg)").
ExperiĂȘncias reais: legendas e cache em clientes
Legendas dessincronizadas ou ausentes no iOS : Alguns usuĂĄrios relatam que, com legendas incorporadas ou SRT ativadas, a sincronização falha ou elas nĂŁo carregam no iPhone, embora funcionem normalmente em outros aplicativos (Web, Tizen, PC Media Player). A equipe geralmente corrige esse problema com atualizaçÔes, mas vale a pena tentar diferentes contĂȘineres e configuraçÔes de legendas.
Problemas de cache ao trocar de servidor ou atualizar : Ao conectar-se a um novo servidor ou após atualizar um aplicativo ainda vinculado ao anterior, a interface pode não ser exibida devido a um cache corrompido. No PC, isso é resolvido limpando o cache do player; no iPhone, reinstalar o aplicativo é a solução mais direta. Uma solicitação frequente é que o botão "Redefinir Aplicativo" também limpe o cache da web.
Como usar Jellyfin na vida cotidiana
Na sala de estar ou em qualquer lugar : acesse suas bibliotecas, continue a reprodução de onde parou, transmita conteĂșdo para o Chromecast ou para sua Smart TV ou ouça mĂșsica com o Android Auto (lembre-se, este Ă© um modo online). Se vocĂȘ ativar a TV ao vivo, poderĂĄ integrar canais e gravaçÔes Ă sua experiĂȘncia de visualização.
A partir do seu navegador e computador : o cliente web Ă© poderoso, e o Jellyfin Media Player para Windows, macOS e Linux oferece aceleração e atalhos de teclado convenientes. VocĂȘ tambĂ©m pode combinĂĄ-lo com o Kodi ou o Infuse, se preferir a interface deles.
Boas pråticas para evitar dores de cabeça com Jellyfin
- Mantenha o servidor atualizado: Além de novos recursos (como Dolby Vision HDR ou AV1), hå correçÔes de bugs do cliente, melhorias no scraper e otimizaçÔes de backend.
- Cuide da bibliotecaUma estrutura clara, nomenclatura consistente e metadados no idioma correto economizam tempo. Aproveite as opçÔes Reprodução > Conversão para equilibrar qualidade e consumo de recursos.
- Plugins com cabeçaInstale apenas o que vocĂȘ usa. DLNA como plugin, Trakt para sincronização, integraçÔes Kodi/Infuse e NextPVR para TV sĂŁo apostas seguras; o resto Ă© teste controlado.
Compatibilidade técnica e notas adicionais do Jellyfin
Escrito em C# e baseado em .NET , o Jellyfin migrou seu frontend web para um sistema separado, preparando-o para um backend SQL e cenĂĄrios de alta disponibilidade com mĂșltiplos servidores. Por padrĂŁo, ele Ă© exposto nas portas 8096/8920, e a API Swagger facilita a integração e a automação de tarefas.
DisponĂvel em vĂĄrios idiomas e com uma comunidade ativa que mantĂ©m traduçÔes (atravĂ©s de plataformas de localização), temas e pacotes de Ăcones. O projeto no GitHub hospeda muitos subprojetos, alĂ©m do servidor, e aceita contribuiçÔes com guias e padrĂ”es da comunidade.
O ecossistema HTPC o posiciona ao lado de Plex, Kodi e Emby como uma opção essencial para home theater, com compatibilidade para decodificadores e sistemas de Smart TV. VocĂȘ pode executĂĄ-lo no Docker e adaptar a implantação Ă sua infraestrutura.
Se vocĂȘ busca controle, privacidade e poder sem assinatura , o Jellyfin Ă© uma Ăłtima opção: flexĂvel em diversas plataformas, compatĂvel com TV ao vivo, plugins e transcodificação, e apoiado por uma comunidade que continua aprimorando e expandindo o projeto.
