Getting Started with mimg

mimg is a blazing-fast command-line image processing tool built with Zig. Get up and running in minutes!

Quick Start

The basic syntax is simple:

mimg input.png [modifiers...] -o output.png

Let’s brighten an image:

mimg photo.png brightness 30 -o brighter.png

The real power comes from chaining multiple modifiers:

mimg photo.png brightness 20 contrast 1.3 sharpen -o enhanced.png

Modifiers are applied left-to-right in the order you specify.

mimg portrait.jpg contrast 1.2 vibrance 0.3 sharpen -o enhanced.jpg

mimg photo.png sepia vignette 0.5 noise 0.05 -o vintage.png

mimg large.png resize 800 600 crop 50 50 700 500 -o result.png

mimg photo.jpg oil-painting 4 posterize 10 -o artistic.jpg

Modifiers fall into three main categories:

Option	Description
`-o <file>`	Output filename
`-d <dir>`	Output directory for batch processing
`-v`	Verbose output with timing information
`--preset <file>`	Load modifier chain from preset file
`--help`	Show help message

Process multiple images at once using wildcards:

# Apply same effects to all JPGs in a folder
mimg *.jpg grayscale contrast 1.2 -d output/

All processed images will be saved to the output/ directory with their original names.

Save your favorite modifier chains in preset files:

vintage.preset:

sepia
vignette 0.5
noise 0.05
contrast 0.9

Apply the preset:

mimg photo.jpg --preset vintage.preset -o output.jpg

You can also chain presets with other modifiers:

mimg photo.jpg --preset base.preset brightness 10 -o output.jpg

Order Matters: Apply modifiers in logical order (e.g., color corrections before artistic effects)
Start Subtle: Begin with small values and increase gradually
Preview First: Test on a single image before batch processing
Save Presets: Create presets for your most-used combinations
Use Verbose: Add -v to see processing time and performance info