img

Inspeciona imagens e altera em lote tamanho, formato e qualidade de JPEG, PNG e WebP.

ArquivosVersão 1.1.4Estável
lil-terminal

Visão geral

img é uma ferramenta pequena para imagens da web: inspeciona sem extensões extras e, com GD ou Imagick, redimensiona ou converte JPEG, PNG e WebP por arquivo, diretório, máscara ou lista.

Processar imagens em lote

Em lotes de imagens, teste primeiro a transformação em um arquivo e depois aplique as mesmas regras de tamanho, formato e qualidade ao diretório ou lista.

Sintaxe

lil-terminal
img <file> [options] · img -f [dir] [mask] [options] · img [options] < <list>

Referência

img <file>

mostrar informações da imagem

-s <size>

redimensionar proporcionalmente; um número limita o lado maior

-s <size> -w | -h

redimensionar proporcionalmente pela largura ou altura escolhida

-s <WxH>

redimensionar para dimensões exatas <WxH>

-t <format>

converter para formato web: jpg|png|webp

-q <1..100>

definir a qualidade da saída; padrão 85

-o <dst>

gravar uma imagem transformada em um destino explícito

-r

substituir a imagem de origem após uma transformação bem-sucedida

-f [dir] [mask]

transformar imagens correspondentes em um diretório; diretório atual e * por padrão

< <list>

transformar caminhos de imagens listados um por linha em um arquivo de texto

Arquivo ativo

Com o core atual, um arquivo aberto com sucesso passa a ficar disponível imediatamente como $. Se este módulo for o manipulador instalado de maior prioridade para a extensão, basta digitar o nome do arquivo para abri-lo por este comando. Esses são atalhos do core; img <file> continua sendo a forma explícita.

Segurança

Por padrão a transformação cria um arquivo vizinho name.img.ext e recusa substituir um destino existente. Use -o para uma saída explícita ou -r somente para substituir a origem conscientemente. O modo em lote não percorre subdiretórios. Com -r, o formato da imagem deve permanecer igual; para converter o formato, omita -r ou use -o.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Inspecionar uma imagem no diretório atual

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install img
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install img -m
Versão pública exata

Instalar exatamente esta versão publicada.

install img -v 1.1.4
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade img
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install img -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Inspecionar uma imagem no diretório atual
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Mostrar informações da imagem
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionar proporcionalmente; um número limita o lado maior
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
Redimensionar proporcionalmente pela largura ou altura escolhida
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
Redimensionar proporcionalmente; um número limita o lado maior
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
Transformar caminhos de imagens listados um por linha em um arquivo de texto
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Substituir a imagem de origem após uma transformação bem-sucedida
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
Mostrar informações da imagem
img \sandbox\images\missing.jpg
Arquivo não encontrado

Arquivo usado neste exemplo: sandbox/images/photo.jpg

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

[binary file: photo.jpg]

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.1.42026-08-09

Redimensionamento proporcional flexível

Adiciona lado maior, largura/altura explícitas, WxH exato e saída compacta origem > resultado.

# Histórico de versões