> ## Documentation Index
> Fetch the complete documentation index at: https://hackmamba-3f164318.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What is ImageMagick

> Command-line tools and libraries for processing, converting, and editing images in 200+ formats.

ImageMagick is **command-line tools and libraries for processing, converting, and editing images in 200+ formats**. Run them in a terminal, call them from any language, or drop them into a CI pipeline to convert, resize, composite, and filter without a GUI, on any OS.

This documentation is for developers and system administrators who need to process images in scripts, build pipelines, or server-side workflows.

It ships on Linux, macOS, and Windows. These pages focus on **ImageMagick 7** and the `magick` driver command.

<Note>
  **v7 docs:** Migrating from v6? Standalone `convert` / `mogrify` are now invoked through `magick`. See the [v6 → v7 porting guide](https://imagemagick.org/script/porting.php).
</Note>

## Who is this for?

<CardGroup cols={3}>
  <Card title="Developers" icon="code">
    Embed ImageMagick in upload pipelines, build steps, CI jobs, or server-side scripts so image work never depends on a desktop app.
  </Card>

  <Card title="Sysadmins" icon="server">
    Batch-resize, convert formats, strip metadata, and enforce policies across thousands of files with repeatable shell or PowerShell loops.
  </Card>

  <Card title="Photographers" icon="camera">
    Automate resizing, watermarking, and format exports from the same commands every time, with no Lightroom session required for bulk output.
  </Card>
</CardGroup>

## Use cases

Each example is a single command you can copy; paths are placeholders.

### Square thumbnails from mixed aspect ratios

```bash theme={null}
magick input.jpg -resize 200x200^ -gravity center -extent 200x200 thumb.jpg
```

`-resize 200x200^` fills at least 200×200, then `-extent` crops to an exact square from the center.

### Batch convert a folder of JPEGs to WebP

```bash theme={null}
mkdir -p web
magick mogrify -path web -format webp -quality 85 *.jpg
```

Writes WebP files into `web/` next to each JPEG basename. The numeric **`-quality`** value is explained under [-quality](/reference/common-options#quality) on the common options page. For subfolders, mixed formats, and `-auto-orient`, see the [batch resize guide](/how-to/batch-resize-and-optimize).

### Quick checks on an upload before you trust it

```bash theme={null}
magick identify -verbose upload.png | grep -E 'Geometry|Format'
```

On **PowerShell**, use `Select-String` instead of `grep`:

```powershell theme={null}
magick identify -verbose upload.png | Select-String -Pattern 'Geometry|Format'
```

## Run your first command

Hands-on install, verification, and your first convert/resize commands belong in **[Getting started](/quickstart)** so this page stays an overview. There you will install ImageMagick, confirm **ImageMagick 7** with `magick --version`, and walk through resize and format conversion with full examples.

## Find what you need

<CardGroup cols={3}>
  <Card title="Setting up for the first time?" icon="rocket" href="/quickstart">
    Install ImageMagick on your OS, confirm `magick --version`, and run your first convert/resize commands in under five minutes.
  </Card>

  <Card title="Have a folder of images to process?" icon="images" href="/how-to/batch-resize-and-optimize">
    Batch resize, convert to WebP or JPEG, strip metadata, fix phone rotation, and cap JPEG size for the web.
  </Card>

  <Card title="Building a multi-step pipeline?" icon="graduation-cap" href="/tutorials/build-image-processing-pipeline">
    Chain resize, metadata stripping, watermarking, and format conversion into one reusable command and loop.
  </Card>
</CardGroup>

## Look up syntax and flags

<CardGroup cols={2}>
  <Card title="Geometry syntax reference" icon="ruler-combined" href="/reference/geometry">
    Understand what `800x600>`, `50%`, and `WxH!` do for `-resize`, `-crop`, and `-extent`, plus offsets and the other modifier flags covered on the reference page.
  </Card>

  <Card title="Common options reference" icon="sliders" href="/reference/common-options">
    `-strip`, `-quality`, `-auto-orient`, `-gravity`, `-background`, and `-composite` with syntax, typical values, and one example each.
  </Card>
</CardGroup>

## Fix a problem

<CardGroup cols={2}>
  <Card title="Troubleshoot common errors" icon="wrench" href="/troubleshooting">
    Missing delegates, authorization failures, cache limits, wrong colors, and platform-specific shell escaping.
  </Card>

  <Card title="Ask the community" icon="comments" href="https://github.com/ImageMagick/ImageMagick/discussions">
    Search past threads or post a new question on GitHub Discussions.
  </Card>
</CardGroup>