Uma CLI inteligente que diagnostica, audita, repara, padroniza e otimiza sua mídia para garantir Direct Play no Jellyfin.

🇬🇧 English | 🇧🇷 Português (Brasil)

✨ Funcionalidades

• 🔍 Análise de Compatibilidade — Matriz de compatibilidade com Direct Play por cliente Jellyfin (Chrome, Firefox, Android TV, etc.).
• 🚀 Limpeza (Remux) — Reencapsula para MKV sem recodificar, preservando qualidade original.
• 🔄 Conversão (Transcode) — Converte para codecs Direct Play (H.264 8-bit / AAC, EAC3 ou FLAC) com regras de fallback configuráveis.
• 🔧 Reparo Forçado — Corrige arquivos com timestamps corrompidos via pipeline intermediário (.w64/.mp4).
• 🔬 Quick Scan + Deep Scan — Verifica integridade do container e analisa quadro a quadro em busca de artefatos e erros.
• 🔬 Myopic Scan — Deep Scan restrito às faixas selecionadas.
• 🎛️ Seleção de Faixas — Escolha quais streams de vídeo, áudio e legenda manter no arquivo final.
• ⏱️ Ajuste de Sincronia / Corte Final — Define offset temporal e corte final para evitar problemas de lip-sync.
• 🔀 Mesclagem de Arquivos — Une faixas de dois arquivos em um único MKV, com sync automático/manual e Modo Estrito.
• 🏷️ Edição de Tags — Edita idioma (ex: por, eng, jpn) e título de cada faixa.
• 🌐 Internacionalização — Interface em Inglês (en-US) e Português do Brasil (pt-BR).
• ⚠️ Detecção de Lixo Embutido — Detecta e remove capas/thumbnails e legendas PGS que forçam transcoding.

🛠️ Pré-requisitos

• FFmpeg & FFprobe (Instalados globalmente no sistema)

📦 Instalação

Execute o script de instalação:

curl -fsSL https://raw.githubusercontent.com/parkejunior/jellycc-cli/main/install.sh | bash

🚀 Uso

Analise e limpeza

Para analisar um arquivo de vídeo, execute o comando:

jellycc

Ou se preferir, você pode abrir o arquivo diretamente no terminal:

jellycc check [caminho/do/arquivo]
# ou
jellycc [caminho/do/arquivo]

Se você quiser executar a análise completa, inclua o parâmetro --deep-scan:

jellycc check [caminho/do/arquivo] --deep-scan

Merclagem

Para mesclar vários arquivos em um único MKV, execute o comando:

jellycc merge

Configuração

Caso queira alterar o idioma da interface ou criar um arquivo de configuração rules.json, execute o comando:

jellycc config

☰ Menu Interativo

Após a análise de um arquivo, um menu interativo é exibido com as seguintes opções:

• 🚀 Limpeza (Remux) — Reencapsula sem recodificar.
• 🔄 Conversão — Converte codecs incompatíveis para Direct Play
• 🔧 Reparo Forçado — Recodificação via pipeline intermediário para arquivos com timestamps corrompidos.
• 🎛️ Modificar faixas — Seleciona quais streams de vídeo, áudio e legenda manter.
• ⏱️ Ajustar Sincronia / Corte Final — Define offset temporal e corte final.
• 🔍 Deep Scan — Análise quadro a quadro de todas as faixas.
• 🔬 Myopic Scan — Deep Scan apenas nas faixas selecionadas.
• 🏷️ Editar Tags — Edita idioma e título de cada faixa.

⚙️ Configuração

Você pode ver a lista completa de configurações na documentação de configuração.

⚖️ Licença

JellyCC é licenciado sob os termos da MIT + Commons Clause.