img

Ispeziona immagini e modifica in batch dimensioni, formato e qualità di JPEG, PNG e WebP.

FileVersione 1.1.4Stabile
lil-terminal

Panoramica

img è un piccolo strumento per immagini web: ispeziona senza estensioni aggiuntive e, con GD o Imagick, ridimensiona o converte JPEG, PNG e WebP per file, directory, maschera o elenco.

Elaborare immagini in gruppo

Per operazioni in batch, provare prima la trasformazione su una sola immagine e poi applicare le stesse regole di dimensione, formato e qualità a directory o elenco.

Sintassi

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

Riferimento

img <file>

mostrare formato, dimensioni, tipo MIME e dimensione del file immagine

-s <size>

ridimensionare proporzionalmente; un numero limita il lato più lungo

-s <size> -w | -h

ridimensionare proporzionalmente in base alla larghezza o all’altezza scelta

-s <WxH>

ridimensionare alle dimensioni esatte <WxH>

-t <format>

convertire nel formato web jpg|png|webp

-q <1..100>

impostare la qualità di output; valore predefinito 85

-o <dst>

scrivere una singola immagine trasformata in una destinazione esplicita

-r

sostituire l’immagine sorgente dopo una trasformazione riuscita

-f [dir] [mask]

trasformare le immagini corrispondenti in una directory; per impostazione predefinita usa la directory corrente e *

< <list>

trasformare i percorsi immagine elencati, uno per riga, in un file di testo

File attivo

Con il core corrente, un file aperto correttamente diventa subito disponibile come $. Se questo modulo è il gestore installato con priorità più alta per l’estensione, basta digitare il nome del file per aprirlo con questo comando. Sono scorciatoie del core; img <file> resta la forma esplicita.

Sicurezza

Per impostazione predefinita una trasformazione crea accanto alla sorgente un file name.img.ext e rifiuta di sostituire una destinazione esistente. Usa -o per indicare una destinazione precisa oppure -r solo quando vuoi sostituire intenzionalmente la sorgente. La modalità batch non attraversa le sottodirectory in modo ricorsivo. Con -r il formato deve restare invariato; per convertirlo, ometti -r oppure usa -o.

Anteprima interattiva del sandbox

Esegui gli esempi preparati direttamente nella pagina. I risultati sono predefiniti e mostrati nel browser; sul server non viene eseguito alcun comando del terminale.

Controllare un’immagine nella directory corrente

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Pacchetto Base

Installa il pacchetto completo con riferimento locale e tutte le modalità pubblicate.

install img
Pacchetto Minimum

Installa il pacchetto ridotto. Il riferimento locale è omesso; help <cmd> -i apre il riferimento server corrente.

install img -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install img -v 1.1.4
Controlla o aggiorna

upgrade controlla la compatibilità e sostituisce il blocco solo quando serve.

upgrade img
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install img -u

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Controllare un’immagine nella directory corrente
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Mostrare formato, dimensioni, tipo MIME e dimensione del file immagine
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Ridimensionare proporzionalmente; un numero limita il lato più lungo
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
Ridimensionare proporzionalmente in base alla larghezza o all’altezza scelta
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
Ridimensionare proporzionalmente; un numero limita il lato più lungo
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
Trasformare i percorsi immagine elencati, uno per riga, in un file di testo
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Sostituire l’immagine sorgente dopo una trasformazione riuscita
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
Mostrare formato, dimensioni, tipo MIME e dimensione del file immagine
img \sandbox\images\missing.jpg
File non trovato

File usato in questo esempio: sandbox/images/photo.jpg

L’esempio usa un file o una directory dell’area di documentazione protetta /sandbox/.

[binary file: photo.jpg]

Documentazione correlata

Come vengono protette le operazioni sul file system? →Perché file grandi e output estesi sono limitati? →

Versione pubblica attuale

v1.1.42026-08-09

Ridimensionamento proporzionale flessibile

Aggiunti lato massimo, larghezza/altezza esplicite, dimensione WxH esatta e output compatto origine > risultato.

# Cronologia versioni