Tool

What it does

image_inspect

Format, width/height, colour mode, alpha, frames, file size, orientation, a safe EXIF subset. GPS is never returned — only whether it is present.

image_convert

Convert to jpeg, png or webp (quality 1–100, WebP lossless). Applies EXIF rotation, removes EXIF/GPS, keeps the colour profile. Optional output_name (no folders, no extension).

image_resize

Resize by width, height or both. fit: contain (default, keep aspect inside the box), cover (fill and centre-crop), exact (stretch). resample: lanczos (default), bicubic, bilinear, nearest (pixel art). Never enlarges unless allow_upscale. Keeps the source format (JPEG/PNG/WebP, else PNG) unless format is set. Same metadata rules as convert. Default name <source>-<W>x<H>.

image_compress

Make a file smaller. JPEG/WebP: quality (default 80) or max_bytes — the highest quality in min_quality…95 that fits is found by binary search. PNG stays lossless (optimised) unless colors (2–256) or max_bytes asks for palette reduction (largest of 256/128/…/2 colours that fits). Reports input_bytes, output_bytes, saved_bytes, quality_used/colors_used, target_met; warns target_not_met (smallest attempt kept) and larger_than_source. Keeps the source format unless format is set. Default name <source>-compressed. Tip: for photos prefer JPEG/WebP; PNG max_bytes on big photos is slow (≈15 s for 6 MP in the cloud test, slower on a phone).

image_rotate_flip

rotate 90/180/270 degrees clockwise and/or flip horizontal (mirror) / vertical; rotation happens first. Directions refer to the photo as displayed (EXIF rotation applied first). Pixel moves are exact; JPEG/lossy-WebP output is re-encoded (warning lossy_reencode — use format: png for an exact copy). Default name <source>-rot90-flipH.

image_crop

Either a box — width, height, optional left/top (default 0) in pixels of the displayed image — or only aspect ("1:1", "16:9"…) for the largest centred crop. Boxes outside the image are refused with [crop_out_of_bounds] and the real size (never silently clamped). Same format/metadata rules as resize. Default name <source>-crop-<W>x<H>.

image_adjust

brightness, contrast, saturation, sharpness as factors (1.0 = unchanged, 0–4), grayscale, autocontrast. Transparency kept. Default name <source>-adjusted.

image_watermark

One line of text (≤ 120 chars) at one of 9 positions, opacity 0–1, size_percent of the shorter side, color, margin_percent. Default name <source>-wm.

image_recipe

Up to 10 steps (resize, crop, rotate_flip, adjust, watermark) applied in memory with one encode. Returns the normalised steps so the same recipe can be re-run exactly. Default name <source>-recipe.

image_tag

New copy whose only metadata is the description, artist and/or copyright you give (EXIF for JPEG/WebP, text chunks for PNG); GPS and camera data still removed. Default name <source>-tagged.

image_batch

Apply one operation (convert, resize, compress, rotate_flip, crop, adjust, watermark) with its options (same as the single tool, no path/output_name) to every image directly inside folder (no sub-folders; optional name pattern like *.jpg). One file at a time; a failing file is reported and the rest continue. dry_run: true only lists the files. Refuses (instead of truncating) more than max_files (default 50, max 200) or 1 GiB in total. Writes a JSON manifest (options, sources, outputs, SHA-256 checksums, failures) to the output folder. Sends progress; on cancel, finished files are kept and recorded. resume_from: "<manifest>.json" skips files that run finished; retries (0–3) retries temporary failures. Rules: ADR-0004.