Quick Start

Get up and running with MediaProc in 5 minutes.

You'll Learn

In this quick start guide, you'll:

  • Install MediaProc CLI and the Image plugin
  • Process your first image with resize, convert, and optimize commands
  • Learn common batch processing tasks

1. Install MediaProc

Terminal
$ npm install -g @mediaproc/cli
✓ Installed @mediaproc/cli

2. Install Image Plugin

Terminal
$ mediaproc add image
✓ Plugin installed successfully

3. Process Your First Image

Resize an Image

Terminal
$ mediaproc image resize photo.jpg --width 1920 --height 1080 -o resized.jpg
✓ Resized to 1920×1080 • Saved as resized.jpg

Convert Format

Terminal
$ mediaproc image convert photo.jpg -o photo.webp
✓ Converted to WebP • 2.4 MB → 1.1 MB (54% smaller)

Optimize for Web

Terminal
$ mediaproc image optimize photo.jpg --quality 85 -o optimized.jpg
✓ Optimized • 3.2 MB → 1.8 MB (44% reduction)

Common Tasks

Batch Resize Multiple Images

Terminal
$ mediaproc image batch-resize *.jpg --width 800 -o thumbnails/
✓ Processed 12 images • Saved to thumbnails/

Add Watermark

Terminal
$ mediaproc image watermark photo.jpg --text "© 2026" --position bottom-right
✓ Watermark applied • Saved as photo-watermarked.jpg

Create Thumbnails

Terminal
$ mediaproc image thumbnail *.jpg --size 200x200 -o thumbs/
✓ Created 24 thumbnails • Saved to thumbs/

Apply Filters

Grayscale
$ mediaproc image grayscale photo.jpg -o bw.jpg
✓ Converted to grayscale
Blur
$ mediaproc image blur photo.jpg --sigma 5 -o blurred.jpg
✓ Applied blur (sigma: 5)
Sharpen
$ mediaproc image sharpen photo.jpg -o sharp.jpg
✓ Sharpened image

Working with Directories

Process all images in a directory:

Terminal
$ mediaproc image resize input-folder/ --width 1920 -o output-folder/
✓ Resized 45 images • Saved to output-folder/
Terminal
$ mediaproc image convert input-folder/ --format webp -o output-folder/
✓ Converted 45 images to WebP
✓ Total size: 48 MB → 21 MB (56% reduction)

Plugin Management

List Installed Plugins (Only Installed Plugins)

Terminal
$ mediaproc list

View Available Plugins (All Official Plugins)

Terminal
$ mediaproc plugins

Update Plugins

Update specific plugin

Terminal
$ mediaproc update image

Update all plugins (Coming Soon...)

Terminal
$ mediaproc update

Delete Specific

Terminal
$ mediaproc delete image

Get Help

CLI Help

Terminal
$ mediaproc help

Plugin Help

Terminal
$ mediaproc image --help

Command Help

Terminal
$ mediaproc image resize --help

What's Next?

Found an issue? Help us improve this page.

Edit on GitHub →