panimg-cli-0.3.0 is not a library.

panimg

The Swiss Army knife of image processing — built for humans and AI agents alike.

Features

Rich command set for format conversion, resize, crop, rotate, color adjustment, filters, text, compositing, animation, compression, and more
Pipeline engine — chain multiple operations in a single read/write pass
Batch processing — process multiple files with glob patterns and parallel execution
AI-agent friendly — structured JSON output, --dry-run, --schema, and --capabilities for programmatic use
Fast & safe — built in Rust, SIMD-accelerated resize, zero unsafe code in the core pipeline (benchmarks)

Installation

Homebrew (macOS / Linux)

brew install tzengyuxio/tap/panimg

Cargo

cargo install panimg-cli

Build from source

git clone https://github.com/tzengyuxio/panimg.git
cd panimg
cargo build --release

See Supported Formats for optional codec feature flags (AVIF, JPEG XL, SVG, PDF, HEIC).

Quick Start

# Get image info
panimg info photo.jpg --format json

# Convert format
panimg convert photo.png -o photo.webp --quality 80

# Convert color space (requires icc feature)
panimg convert photo.jpg --convert-profile display-p3 -o photo-p3.jpg

# Convert PDF first page to PNG (requires pdf feature)
panimg convert document.pdf -o page1.png --dpi 300

# Convert HEIC to JPEG (requires heic feature, macOS only)
panimg convert photo.heic -o photo.jpg

# Resize with fit mode
panimg resize photo.jpg --width 800 --height 600 --fit cover -o thumb.jpg

# Color adjustment
panimg saturate photo.jpg --factor 1.5 -o vivid.jpg

# Apply filter
panimg blur photo.jpg --sigma 3.0 -o blurred.jpg

# Add watermark text
panimg text photo.jpg --content "© 2026" --size 24 --color white --position bottom-right -o stamped.jpg

# Smart compression
panimg tiny photo.png -o compressed.png

# Multi-step pipeline
panimg pipeline photo.jpg -o result.jpg --steps "resize --width 800 | blur --sigma 1.5 | grayscale"

# Batch processing
panimg batch convert 'photos/*.png' --output-dir ./webp --to webp --quality 80

See Command Reference for full usage and examples.

Commands

Info & Conversion

Command	Description
`info`	Show image metadata and properties
`convert`	Convert image between formats
`tiny`	Smart compression (like TinyPNG)

Transform

Command	Description
`resize`	Resize with multiple fit modes
`crop`	Crop a rectangular region
`smart-crop`	Auto-select best crop region (entropy/attention)
`trim`	Auto-crop whitespace or similar-colored borders
`rotate`	Rotate by any angle (90/180/270 use fast lossless path)
`flip`	Mirror horizontally or vertically
`auto-orient`	Auto-rotate based on EXIF orientation

Color & Tone

Command	Description
`brightness`	Adjust image brightness
`contrast`	Adjust image contrast
`hue-rotate`	Rotate image hue
`saturate`	Adjust color saturation
`grayscale`	Convert to grayscale
`invert`	Invert (negate) colors
`sepia`	Apply sepia tone effect
`tint`	Tint with a color
`posterize`	Reduce color levels per channel

Filters & Effects

Command	Description
`blur`	Apply Gaussian blur
`sharpen`	Sharpen using unsharp mask
`edge-detect`	Detect edges (Laplacian kernel)
`emboss`	Apply emboss effect
`tilt-shift`	Miniature/diorama tilt-shift effect

Compose & Draw

Command	Description
`draw`	Draw shapes (rect, circle, line)
`text`	Draw text with embedded or custom fonts
`overlay`	Composite one image on another

Compare & Animate

Command	Description
`diff`	Compare two images and visualize differences
`frames`	Extract frames from animated GIF
`animate`	Assemble images into animated GIF
`gif-speed`	Change animation playback speed

Automation

Command	Description
`pipeline`	Run multiple operations in one pass
`batch`	Process multiple files with glob patterns