Image Manipulation Image Magick

1---2name: image-manipulation-image-magick3description: Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch processing, and retrieving image metadata. Use when working with images, creating thumbnails, resizing wallpapers, or performing batch image operations.4compatibility: Requires ImageMagick installed and available as `magick` on PATH. Cross-platform examples provided for PowerShell (Windows) and Bash (Linux/macOS).5---6 7# Image Manipulation with ImageMagick8 9This skill enables image processing and manipulation tasks using ImageMagick10across Windows, Linux, and macOS systems.11 12## When to Use This Skill13 14Use this skill when you need to:15 16- Resize images (single or batch)17- Get image dimensions and metadata18- Convert between image formats19- Create thumbnails20- Process wallpapers for different screen sizes21- Batch process multiple images with specific criteria22 23## Prerequisites24 25- ImageMagick installed on the system26- **Windows**: PowerShell with ImageMagick available as `magick` (or at `C:\Program Files\ImageMagick-*\magick.exe`)27- **Linux/macOS**: Bash with ImageMagick installed via package manager (`apt`, `brew`, etc.)28 29## Core Capabilities30 31### 1. Image Information32 33- Get image dimensions (width x height)34- Retrieve detailed metadata (format, color space, etc.)35- Identify image format36 37### 2. Image Resizing38 39- Resize single images40- Batch resize multiple images41- Create thumbnails with specific dimensions42- Maintain aspect ratios43 44### 3. Batch Processing45 46- Process images based on dimensions47- Filter and process specific file types48- Apply transformations to multiple files49 50## Usage Examples51 52### Example 0: Resolve `magick` executable53 54**PowerShell (Windows):**55```powershell56# Prefer ImageMagick on PATH57$magick = (Get-Command magick -ErrorAction SilentlyContinue)?.Source58 59# Fallback: common install pattern under Program Files60if (-not $magick) {61    $magick = Get-ChildItem "C:\\Program Files\\ImageMagick-*\\magick.exe" -ErrorAction SilentlyContinue |62        Select-Object -First 1 -ExpandProperty FullName63}64 65if (-not $magick) {66    throw "ImageMagick not found. Install it and/or add 'magick' to PATH."67}68```69 70**Bash (Linux/macOS):**71```bash72# Check if magick is available on PATH73if ! command -v magick &> /dev/null; then74    echo "ImageMagick not found. Install it using your package manager:"75    echo "  Ubuntu/Debian: sudo apt install imagemagick"76    echo "  macOS: brew install imagemagick"77    exit 178fi79```80 81### Example 1: Get Image Dimensions82 83**PowerShell (Windows):**84```powershell85# For a single image86& $magick identify -format "%wx%h" path/to/image.jpg87 88# For multiple images89Get-ChildItem "path/to/images/*" | ForEach-Object { 90    $dimensions = & $magick identify -format "%f: %wx%h`n" $_.FullName91    Write-Host $dimensions 92}93```94 95**Bash (Linux/macOS):**96```bash97# For a single image98magick identify -format "%wx%h" path/to/image.jpg99 100# For multiple images101for img in path/to/images/*; do102    magick identify -format "%f: %wx%h\n" "$img"103done104```105 106### Example 2: Resize Images107 108**PowerShell (Windows):**109```powershell110# Resize a single image111& $magick input.jpg -resize 427x240 output.jpg112 113# Batch resize images114Get-ChildItem "path/to/images/*" | ForEach-Object { 115    & $magick $_.FullName -resize 427x240 "path/to/output/thumb_$($_.Name)"116}117```118 119**Bash (Linux/macOS):**120```bash121# Resize a single image122magick input.jpg -resize 427x240 output.jpg123 124# Batch resize images125for img in path/to/images/*; do126    filename=$(basename "$img")127    magick "$img" -resize 427x240 "path/to/output/thumb_$filename"128done129```130 131### Example 3: Get Detailed Image Information132 133**PowerShell (Windows):**134```powershell135# Get verbose information about an image136& $magick identify -verbose path/to/image.jpg137```138 139**Bash (Linux/macOS):**140```bash141# Get verbose information about an image142magick identify -verbose path/to/image.jpg143```144 145### Example 4: Process Images Based on Dimensions146 147**PowerShell (Windows):**148```powershell149Get-ChildItem "path/to/images/*" | ForEach-Object { 150    $dimensions = & $magick identify -format "%w,%h" $_.FullName151    if ($dimensions) {152        $width,$height = $dimensions -split ','153        if ([int]$width -eq 2560 -or [int]$height -eq 1440) {154            Write-Host "Processing $($_.Name)"155            & $magick $_.FullName -resize 427x240 "path/to/output/thumb_$($_.Name)"156        }157    }158}159```160 161**Bash (Linux/macOS):**162```bash163for img in path/to/images/*; do164    dimensions=$(magick identify -format "%w,%h" "$img")165    if [[ -n "$dimensions" ]]; then166        width=$(echo "$dimensions" | cut -d',' -f1)167        height=$(echo "$dimensions" | cut -d',' -f2)168        if [[ "$width" -eq 2560 || "$height" -eq 1440 ]]; then169            filename=$(basename "$img")170            echo "Processing $filename"171            magick "$img" -resize 427x240 "path/to/output/thumb_$filename"172        fi173    fi174done175```176 177## Guidelines178 1791. **Always quote file paths** - Use quotes around file paths that might contain spaces1802. **Use the `&` operator (PowerShell)** - Invoke the magick executable using `&` in PowerShell1813. **Store the path in a variable (PowerShell)** - Assign the ImageMagick path to `$magick` for cleaner code1824. **Wrap in loops** - When processing multiple files, use `ForEach-Object` (PowerShell) or `for` loops (Bash)1835. **Verify dimensions first** - Check image dimensions before processing to avoid unnecessary operations1846. **Use appropriate resize flags** - Consider using `!` to force exact dimensions or `^` for minimum dimensions185 186## Common Patterns187 188### PowerShell Patterns189 190#### Pattern: Store ImageMagick Path191 192```powershell193$magick = (Get-Command magick).Source194```195 196#### Pattern: Get Dimensions as Variables197 198```powershell199$dimensions = & $magick identify -format "%w,%h" $_.FullName200$width,$height = $dimensions -split ','201```202 203#### Pattern: Conditional Processing204 205```powershell206if ([int]$width -gt 1920) {207    & $magick $_.FullName -resize 1920x1080 $outputPath208}209```210 211#### Pattern: Create Thumbnails212 213```powershell214& $magick $_.FullName -resize 427x240 "thumbnails/thumb_$($_.Name)"215```216 217### Bash Patterns218 219#### Pattern: Check ImageMagick Installation220 221```bash222command -v magick &> /dev/null || { echo "ImageMagick required"; exit 1; }223```224 225#### Pattern: Get Dimensions as Variables226 227```bash228dimensions=$(magick identify -format "%w,%h" "$img")229width=$(echo "$dimensions" | cut -d',' -f1)230height=$(echo "$dimensions" | cut -d',' -f2)231```232 233#### Pattern: Conditional Processing234 235```bash236if [[ "$width" -gt 1920 ]]; then237    magick "$img" -resize 1920x1080 "$outputPath"238fi239```240 241#### Pattern: Create Thumbnails242 243```bash244filename=$(basename "$img")245magick "$img" -resize 427x240 "thumbnails/thumb_$filename"246```247 248## Limitations249 250- Large batch operations may be memory-intensive251- Some complex operations may require additional ImageMagick delegates252- On older Linux systems, use `convert` instead of `magick` (ImageMagick 6.x vs 7.x)