img

Inspecciona imágenes y cambia por lotes el tamaño, formato y calidad de JPEG, PNG y WebP.

ArchivosVersión 1.1.4Estable
lil-terminal

Resumen

img es una herramienta compacta para imágenes web: inspecciona sin extensiones adicionales y, con GD o Imagick, redimensiona o convierte JPEG, PNG y WebP por archivo, directorio, máscara o lista.

Procesar imágenes por lotes

Para procesos por lotes, pruebe primero la transformación en una imagen y después aplique las mismas reglas de tamaño, formato y calidad al directorio o lista.

Sintaxis

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

Referencia

img <file>

mostrar información de la imagen

-s <size>

redimensionar proporcionalmente; un número limita el lado mayor

-s <size> -w | -h

redimensionar proporcionalmente por ancho o alto elegido

-s <WxH>

redimensionar a dimensiones exactas <WxH>

-t <format>

convertir a formato web: jpg|png|webp

-q <1..100>

definir la calidad de salida; 85 de forma predeterminada

-o <dst>

escribir una imagen transformada en un destino explícito

-r

reemplazar la imagen de origen tras una transformación correcta

-f [dir] [mask]

transformar imágenes coincidentes de un directorio; por defecto el directorio actual y *

< <list>

transformar rutas de imágenes listadas una por línea en un archivo de texto

Archivo activo

Con el core actual, un archivo abierto correctamente queda disponible de inmediato como $. Si este módulo es el controlador instalado con mayor prioridad para la extensión, basta escribir el nombre del archivo para abrirlo con este comando. Son comodidades del core; img <file> sigue siendo la forma explícita.

Seguridad

Por defecto se crea un archivo vecino name.img.ext y no se reemplaza un destino existente. Use -o para una salida explícita o -r solo cuando quiera reemplazar el origen. El modo por lotes no recorre subdirectorios. Con -r el formato de imagen debe permanecer igual; para convertir a otro formato, omita -r o use -o.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Inspeccionar una imagen del directorio actual

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install img
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install img -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install img -v 1.1.4
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade img
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install img -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Inspeccionar una imagen del directorio actual
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Mostrar información de la imagen
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionar proporcionalmente; un número limita el lado mayor
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
Redimensionar proporcionalmente por ancho o alto elegido
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
Redimensionar proporcionalmente; un número limita el lado mayor
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
Transformar rutas de imágenes listadas una por línea en un archivo de texto
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Reemplazar la imagen de origen tras una transformación correcta
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
Mostrar información de la imagen
img \sandbox\images\missing.jpg
Archivo no encontrado

Archivo usado en este ejemplo: sandbox/images/photo.jpg

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

[binary file: photo.jpg]

Documentación relacionada

¿Cómo se protegen las operaciones del sistema de archivos? →¿Por qué se limitan los archivos grandes y la cantidad de salida? →

Versión pública actual

v1.1.42026-08-09

Redimensionado proporcional flexible

Se añaden lado mayor, ancho/alto explícitos, tamaño WxH exacto y salida compacta origen > resultado.

# Historial de versiones