Image Processing Plugin

Professional image processing and manipulation toolkit with 51 powerful commands.

Overview

The Image plugin provides comprehensive image processing capabilities including resizing, format conversion, filters, effects, optimization, and batch operations. Built on Sharp for high-performance processing.

Purpose

The Image plugin is designed to handle all your image processing needs from the command line. Whether you're optimizing images for the web, creating thumbnails, applying filters, or batch processing thousands of images, this plugin provides the tools you need with a simple, consistent interface.

Installation

To install the Image plugin:

Terminal
$ npm install -g @mediaproc/plugin-image

Key Features

High-Performance Image Processing

The Image plugin is powered by Sharp, which uses libvips for blazing-fast image processing. It can handle large images and batch operations efficiently with minimal memory usage.

  • 51 specialized commands for every image processing need
  • Multiple format support: JPEG, PNG, WebP, AVIF, TIFF, GIF
  • High performance powered by Sharp (libvips)
  • Batch processing for efficient bulk operations
  • Smart algorithms for resizing, cropping, and optimization
  • Metadata management (EXIF, IPTC, XMP)
  • Color manipulation and corrections
  • Filters and effects for artistic results
  • Watermarking and text overlays
  • Web optimization with automatic compression

Common Use Cases

  • Web Development: Optimize and resize images for websites
  • E-commerce: Process product photos, create thumbnails
  • Photography: Batch process, watermark, color grade photos
  • Social Media: Create properly sized images for platforms
  • Print Preparation: Convert formats, adjust quality
  • Content Management: Automate image workflows
  • Mobile Apps: Generate app icons and splash screens
  • Design Assets: Create design mockups and templates

Commands by Category

Transformation

  • resize - Resize images with various fit modes
  • crop - Crop to specific dimensions or smart crop
  • rotate - Rotate by any angle
  • flip - Flip horizontally (mirror)
  • flop - Flip vertically
  • trim - Auto-remove borders
  • extend - Add padding/borders
  • affine - Advanced transformations
  • compress - Advanced compression with quality control

Format & Optimization

Effects & Filters

Color Adjustments

  • modulate - Brightness, saturation, hue
  • tint - Apply color tints
  • gamma - Gamma correction
  • linear - Linear color adjustment
  • recomb - Channel recombination

Overlays & Composition

Metadata & Info

  • info - Comprehensive image information
  • metadata-cmd - Manage all metadata
  • stats - Technical color statistics

Batch Operations

  • batch - Batch operations

Advanced

Quick Start

Install

Terminal
$ npm install @mediaproc/plugin-image
✓ Installed @mediaproc/plugin-image

Basic Usage

Terminal
$ mediaproc image resize input.jpg -w 800 -h 600 -o output.jpg
✓ Resized to 800×600 • Saved as output.jpg
Terminal
$ mediaproc image convert photo.png -f webp -o photo.webp
✓ Converted to WebP • 845 KB → 312 KB
Terminal
$ mediaproc image optimize large.jpg -q 80 -o optimized.jpg
✓ Optimized • 3.2 MB → 1.8 MB (44% reduction)

Batch Processing

Terminal
$ mediaproc image batch-resize "photos/*.jpg" -w 1920 -h 1080 -o ./resized
✓ Processed 24 images • Saved to ./resized
Terminal
$ mediaproc image batch-convert "*.png" -f webp -q 85 -o ./webp
✓ Converted 18 images to WebP
✓ Total size: 12.4 MB → 4.8 MB (61% reduction)

Performance

The Image plugin uses Sharp, which is built on libvips - one of the fastest image processing libraries available:

  • 4-5x faster than ImageMagick
  • 10x faster than GraphicsMagick
  • Memory efficient streaming processing
  • Optimized for modern CPUs with SIMD
  • Handles very large images efficiently

Support & Community


Next Steps: Explore the commands in the sidebar to see detailed documentation, examples, and best practices for each operation.

Found an issue? Help us improve this page.

Edit on GitHub →