Image manipulation toolkit powered by ImageMagick. Provides commands for resizing, format conversion, compression, metadata inspection, watermarking, metadata stripping, thumbnail generation, and image comparison.
aux4 aux4 pkger install aux4/imageRequires ImageMagick v7+ to be installed. The package will attempt to install it automatically via your system package manager if not found.
# Resize an image
aux4 image resize photo.jpg --size 800x600 --output photo-small.jpg
# Convert to WebP
aux4 image convert photo.jpg --format webp
# Generate a thumbnail
aux4 image thumbnail photo.jpg --size 150x150 --output thumb.jpg
# Get image info
aux4 image info photo.jpgResize an image by pixel dimensions or percentage.
aux4 image resize <input> --size <size> --output <file>Supports absolute dimensions (800x600), single-axis constraints (800x, x600), percentage (50%), and forced exact dimensions (800x600!).
aux4 image resize photo.jpg --size 800x600 --output photo-resized.jpgResized photo.jpg to 800x600 -> photo-resized.jpgConvert an image between formats (JPEG, PNG, WebP, TIFF, GIF, BMP).
aux4 image convert <input> --format <format> [--output <file>]If --output is omitted, the output file uses the input name with the new extension.
aux4 image convert photo.jpg --format webpConverted photo.jpg -> photo.webpReduce image file size by adjusting quality and stripping metadata.
aux4 image compress <input> [--quality <1-100>] --output <file>aux4 image compress photo.jpg --quality 75 --output photo-compressed.jpgCompressed photo.jpg (quality: 75) -> photo-compressed.jpgDisplay image metadata and properties.
aux4 image info <input> [--verbose <true|false>]Use --verbose true for detailed metadata including EXIF data, color space, and image statistics.
aux4 image info photo.jpgphoto.jpg JPEG 4032x3024 4032x3024+0+0 8-bit sRGB 3.2MB 0.000u 0:00.000Apply a text watermark to an image.
aux4 image watermark <input> --text <text> [--gravity <position>] [--color <color>] [--fontSize <size>] [--font <font>] --output <file>Supports 9 gravity positions (NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast).
aux4 image watermark photo.jpg --text "© 2025 MyBrand" --output photo-branded.jpgWatermarked photo.jpg -> photo-branded.jpgRemove EXIF and metadata from an image (GPS, camera info, timestamps).
aux4 image strip <input> [--output <file>]Without --output, the input file is modified in place.
aux4 image strip photo.jpg --output photo-clean.jpgStripped metadata from photo.jpg -> photo-clean.jpgGenerate a thumbnail with smart center-cropping to exact dimensions.
aux4 image thumbnail <input> [--size <WxH>] --output <file>Unlike resize, thumbnail fills the exact target dimensions by cropping from the center.
aux4 image thumbnail photo.jpg --size 300x200 --output thumb.jpgThumbnail photo.jpg (300x200) -> thumb.jpgCrop a rectangular region from an image.
aux4 image crop <input> --geometry <WxH+X+Y> --output <file>Uses ImageMagick geometry format: width x height + X offset + Y offset from the top-left corner.
aux4 image crop photo.jpg --geometry 300x200+50+100 --output photo-cropped.jpgCropped photo.jpg (300x200+50+100) -> photo-cropped.jpgOverlay a labeled coordinate grid on an image. Useful for vision-LLM bounding-box prompts.
aux4 image grid <input> --output <file> [--step <px>] [--labelStep <px>] [--color <color>] [--fontSize <size>] [--font <path>]aux4 image grid photo.jpg --step 50 --labelStep 100 --output photo-grid.jpgGrid overlay on photo.jpg (step: 50px, labels: 100px) -> photo-grid.jpgPaint a solid-color rectangle over a region of an image. Useful for redacting content.
aux4 image mask <input> --output <file> --geometry <WxH+X+Y> [--color <color>]aux4 image mask scan.png --geometry 80x90+20+30 --color white --output scan-redacted.pngMasked scan.png (80x90+20+30, white) -> scan-redacted.pngDraw outlined rectangles on an image for visual debugging or annotation.
aux4 image rect <input> --rect <WxH+X+Y> [--rect ...] --output <file> [--color <color>] [--strokeWidth <px>]Supports multiple --rect flags to draw several rectangles in one call.
aux4 image rect photo.jpg --rect 200x100+50+30 --rect 150x80+300+200 --color blue --output annotated.jpgDrew rectangles on photo.jpg -> annotated.jpgCompare two images and produce a visual diff highlighting differences.
aux4 image compare <input> --input2 <file> [--output <file>] [--metric <metric>]Supported metrics: AE, RMSE, PSNR, SSIM, MAE.
aux4 image compare original.png --input2 modified.png --metric SSIMCompared original.png and modified.png (SSIM) -> diff.png