img

Inspecte les images et modifie par lot la taille, le format et la qualité des JPEG, PNG et WebP.

FichiersVersion 1.1.4Stable
lil-terminal

Vue d’ensemble

img est un petit atelier pour les images web : inspection sans extension supplémentaire, puis redimensionnement ou conversion JPEG, PNG et WebP avec GD ou Imagick, par fichier, dossier, masque ou liste.

Traiter des images par lot

Pour un traitement par lot, testez d’abord la transformation sur une image, puis appliquez les mêmes règles de taille, format et qualité au dossier ou à la liste.

Syntaxe

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

Référence

img <file>

afficher les informations de l’image

-s <size>

redimensionner proportionnellement ; un nombre limite le côté le plus long

-s <size> -w | -h

redimensionner proportionnellement selon la largeur ou la hauteur choisie

-s <WxH>

redimensionner aux dimensions exactes <WxH>

-t <format>

convertir vers un format web : jpg|png|webp

-q <1..100>

définir la qualité de sortie ; 85 par défaut

-o <dst>

écrire une image transformée vers une destination explicite

-r

remplacer l’image source après une transformation réussie

-f [dir] [mask]

transformer les images correspondantes d’un répertoire ; répertoire courant et * par défaut

< <list>

transformer les chemins d’images listés ligne par ligne dans un fichier texte

Fichier actif

Avec le core actuel, tout fichier ouvert avec succès devient immédiatement disponible sous $. Si ce module est le gestionnaire installé prioritaire pour l’extension, saisir uniquement le nom du fichier suffit à l’ouvrir avec cette commande. Ces raccourcis appartiennent au core ; img <file> reste la forme explicite.

Sécurité

Par défaut, une transformation crée un fichier voisin name.img.ext et refuse d’écraser une destination existante. Utilisez -o pour une sortie explicite ou -r uniquement pour remplacer la source. Le mode lot ne parcourt pas les sous-répertoires. Avec -r, le format de l’image doit rester identique ; pour convertir le format, omettez -r ou utilisez -o.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Inspecter une image du répertoire courant

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install img
Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install img -m
Version publique exacte

Installer exactement cette version publiée.

install img -v 1.1.4
Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade img
Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install img -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Inspecter une image du répertoire courant
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Afficher les informations de l’image
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionner proportionnellement ; un nombre limite le côté le plus long
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
Redimensionner proportionnellement selon la largeur ou la hauteur choisie
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
Redimensionner proportionnellement ; un nombre limite le côté le plus long
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
Transformer les chemins d’images listés ligne par ligne dans un fichier texte
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Remplacer l’image source après une transformation réussie
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
Afficher les informations de l’image
img \sandbox\images\missing.jpg
Fichier introuvable

Fichier utilisé dans cet exemple: sandbox/images/photo.jpg

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /sandbox/.

[binary file: photo.jpg]

Documentation associée

Comment les opérations sur les fichiers sont-elles protégées ? →Pourquoi les gros fichiers et les longues sorties sont-ils limités ? →

Version publique actuelle

v1.1.42026-08-09

Redimensionnement proportionnel flexible

Ajout du côté maximal, largeur/hauteur explicites, taille WxH exacte et sortie compacte source > résultat.

# Historique des versions