optimo

O que é optimo?

optimo é um CLI gratuito e open-source para otimizar e converter imagens e vídeos para a web. Ele aplica fluxos de compressão específicos por formato baseados em ImageMagick para imagens e FFmpeg para vídeos, gerando arquivos menores com resultados previsíveis.

O propósito principal do optimo é pegar mídias que você já tem (arquivos ou diretórios) e executar etapas de otimização confiáveis — opcionalmente incluindo conversão de formato e redimensionamento — sem exigir que você monte manualmente ferramentas e flags diferentes para cada formato.

Principais Recursos

• Pipelines específicas por formato para diversos formatos web: Usa etapas baseadas em ImageMagick para formatos de imagem (ex.: PNG, JPEG, WebP, AVIF, HEIC, JPEG XL, GIF, SVG) e compressão baseada em FFmpeg para formatos de vídeo (ex.: MP4, WebM, MOV, MKV, AVI, OGV).
• Sem perdas por padrão, modo com perdas opcional: Executa compressão sem perdas preservando a qualidade, a menos que você ative --lossy para compressão máxima.
• Controles de redimensionamento em uma flag: Redimensione por porcentagem (ex.: 50%), tamanho de arquivo alvo (ex.: 100kB) ou restrinja dimensões com w{number} / h{number}.
• Modo dry-run para prévias seguras: --dry-run mostra o que mudaria sem modificar arquivos — útil para testes e verificações em CI.
• Processamento em lote e recursivo de diretórios: Processa diretórios recursivamente, ignorando arquivos ocultos e formatos não suportados automaticamente.
• API programática pronta para Node.js / TypeScript: Use optimo em scripts para otimizar arquivos únicos (optimo.file) ou diretórios (optimo.dir), com dados de resultado incluindo tamanhos original/otimizado.
• Controle via CLI com flags simples: Inclui opções como --format (formato de saída), --mute (remove trilhas de áudio; padrão true) e controles de log como --verbose e --silent.
• Requer binários externos para formatos suportados: Optimo localiza compressores necessários do seu PATH e gera erro se os binários indispensáveis estiverem ausentes (por exemplo, ferramentas ImageMagick para formatos de imagem e FFmpeg para vídeos).

Como Usar optimo

Comece executando optimo com --dry-run para verificar quais arquivos seriam otimizados e como as saídas mudariam. Depois, teste em um arquivo único primeiro e só após confirmar os resultados, execute em diretórios para processamento em lote.

Fluxos comuns incluem (1) otimização no local para um formato dado, (2) redimensionamento com --resize quando dimensões ou tamanho precisam mudar e (3) conversão para formato de saída especificado com --format apenas quando a conversão é intencional.

Casos de Uso

• Reduza carregamento de página e armazenamento para conjuntos mistos de imagens: Otimize um diretório de assets com PNG, JPEG, WebP, AVIF/HEIC, GIF e SVG em uma única execução, em vez de lidar com cada formato separadamente.
• Aplique redimensionamento controlado para layouts responsivos: Use --resize para escalar por porcentagem ou restringir por largura/altura (ex.: w960 ou h480) antes de confirmar assets otimizados.
• Encolha mídias agressivamente quando banda importa: Ative --lossy quando precisar de compressão máxima em vez de preservar qualidade com padrões sem perdas.
• Otimize exportações de vídeo com compressão web-oriented: Comprima diretórios de vídeo usando configurações baseadas em FFmpeg, opcionalmente silenciando/removendo trilhas de áudio via --mute (padrão true).
• Integre em verificações automáticas e controle de versão: Execute --dry-run para validação em CI e configure um pre-commit hook para que arquivos de mídia em staging sejam auto-otimizados antes do commit.

FAQ

No que optimo se baseia?
Optimo usa ImageMagick para processamento de imagens e FFmpeg para compressão de vídeos.

optimo modifica arquivos por padrão?
Não — use --dry-run para pré-visualizar mudanças sem modificar arquivos. Sem --dry-run, optimo executa otimização nos inputs fornecidos.

Posso escolher formatos de saída?
Sim. Use a opção --format para converter saída para um formato especificado (por exemplo, converter uma imagem para webp). A documentação fonte nota usar --format apenas quando conversão é intencional.

Como optimo lida com processamento em lote?
Você pode passar diretórios para processamento recursivo. Arquivos ocultos e formatos não suportados são ignorados automaticamente.

Quais ferramentas preciso instalar?
Optimo localiza compressores necessários do seu PATH e gera erro se binários requeridos estiverem ausentes. Os binários necessários variam por formato (ex.: ferramentas relacionadas a ImageMagick para formatos de imagem, FFmpeg para vídeos).

Alternativas

• Pipelines genéricas de otimização de imagem/vídeo que você monta manualmente: Usar ferramentas e flags separadas manualmente (incluindo ImageMagick/FFmpeg diretamente) pode ser flexível, mas geralmente exige decisões específicas por formato que o optimo centraliza.
• Ferramentas focadas em conversão de formato: Ferramentas que convertem principalmente entre formatos de imagem/vídeo podem não oferecer as mesmas pipelines de compressão específicas por formato e padrões otimizados para web.
• Plugins de sistema de build ou pipeline de assets: Integrações de pipeline de assets podem automatizar a otimização durante builds, mas o fluxo de trabalho e o nível de controle (ex.: redimensionamento por tamanho de arquivo ou prévias dry-run) podem diferir de uma ferramenta CLI-first como o optimo.