FGP ImageMagick Daemon

Ultra-fast image processing with persistent ImageMagick instance. 5-25x faster than spawning convert per command.

Why FGP?

| Operation | FGP Daemon | Direct convert | Speedup | |-----------|------------|----------------|---------| | Identify/info | 1-3ms | ~40ms | 15-40x | | Resize | 5-15ms | ~60ms | 4-12x | | Convert format | 3-10ms | ~50ms | 5-17x | | Thumbnail | 4-12ms | ~55ms | 5-14x |

Persistent daemon eliminates process spawn overhead.

Installation

brew install fast-gateway-protocol/tap/fgp-imagemagick

# Or
bash ~/.claude/skills/fgp-imagemagick/scripts/install.sh

Prerequisites

ImageMagick must be installed:

# macOS
brew install imagemagick

# Ubuntu/Debian
sudo apt install imagemagick

# Verify
magick --version  # or convert --version

Usage

Info / Identify

# Get image info
fgp im info image.jpg

# Get dimensions only
fgp im size image.jpg

# Get format
fgp im format image.jpg

# Detailed metadata (EXIF, etc.)
fgp im identify image.jpg --verbose

# Get specific property
fgp im identify image.jpg --property width
fgp im identify image.jpg --property colorspace

Format Conversion

# Convert to PNG
fgp im convert image.jpg --to png

# Convert to WebP
fgp im convert image.png --to webp

# Convert to JPEG with quality
fgp im convert image.png --to jpg --quality 85

# Convert to AVIF (modern format)
fgp im convert image.jpg --to avif

# Convert to ICO (favicon)
fgp im convert logo.png --to ico --sizes 16,32,48

# Convert to PDF
fgp im convert image.jpg --to pdf

Resize / Scale

# Resize to specific dimensions
fgp im resize image.jpg --size 800x600

# Resize by width (maintain aspect)
fgp im resize image.jpg --width 1200

# Resize by height (maintain aspect)
fgp im resize image.jpg --height 800

# Scale by percentage
fgp im resize image.jpg --scale 50%

# Resize to fit within bounds (contain)
fgp im resize image.jpg --fit 1920x1080

# Resize to fill bounds (cover)
fgp im resize image.jpg --fill 1920x1080

# Resize with specific algorithm
fgp im resize image.jpg --width 800 --filter lanczos

Thumbnails

# Create thumbnail
fgp im thumbnail image.jpg --size 150x150

# Thumbnail with crop (exact size)
fgp im thumbnail image.jpg --size 150x150 --crop

# Multiple thumbnail sizes
fgp im thumbnail image.jpg --sizes "150x150,300x300,600x600"

# Thumbnail strip (multiple images in one)
fgp im thumbnail-strip *.jpg --size 100x100 --output strip.jpg

Crop

# Crop to size from center
fgp im crop image.jpg --size 800x600

# Crop with offset
fgp im crop image.jpg --size 800x600 --x 100 --y 50

# Crop with gravity
fgp im crop image.jpg --size 800x600 --gravity center
fgp im crop image.jpg --size 800x600 --gravity northwest

# Smart crop (content-aware)
fgp im crop image.jpg --size 800x600 --smart

# Trim whitespace/borders
fgp im trim image.jpg

# Trim with fuzz tolerance
fgp im trim image.jpg --fuzz 10%

Compress / Optimize

# Optimize JPEG
fgp im compress image.jpg --quality 80

# Optimize PNG (lossless)
fgp im compress image.png

# Aggressive compression
fgp im compress image.jpg --quality 60

# Strip metadata (reduce size)
fgp im compress image.jpg --strip

# Target file size
fgp im compress image.jpg --target-size 100KB

# Web optimization preset
fgp im compress image.jpg --preset web

Watermark / Overlay

# Add image watermark
fgp im watermark image.jpg --image logo.png

# Position watermark
fgp im watermark image.jpg --image logo.png --position bottom-right
fgp im watermark image.jpg --image logo.png --gravity southeast --offset 10x10

# Watermark with opacity
fgp im watermark image.jpg --image logo.png --opacity 50%

# Text watermark
fgp im watermark image.jpg --text "© 2024 Company"

# Text with styling
fgp im watermark image.jpg --text "© 2024" --font "Arial" --size 24 --color white

Effects & Filters

# Blur
fgp im blur image.jpg --radius 5

# Gaussian blur
fgp im blur image.jpg --gaussian 0x3

# Sharpen
fgp im sharpen image.jpg

# Grayscale
fgp im grayscale image.jpg

# Sepia
fgp im sepia image.jpg

# Negate/Invert
fgp im negate image.jpg

# Adjust brightness/contrast
fgp im adjust image.jpg --brightness 10 --contrast 20

# Adjust saturation
fgp im adjust image.jpg --saturation 120%

# Auto-enhance
fgp im enhance image.jpg

# Normalize/stretch histogram
fgp im normalize image.jpg

Rotate / Flip

# Rotate by degrees
fgp im rotate image.jpg --degrees 90
fgp im rotate image.jpg --degrees -45

# Auto-rotate based on EXIF
fgp im rotate image.jpg --auto

# Flip horizontal
fgp im flip image.jpg --horizontal

# Flip vertical
fgp im flip image.jpg --vertical

# Transpose
fgp im transpose image.jpg

Color Operations

# Convert colorspace
fgp im colorspace image.jpg --to srgb
fgp im colorspace image.jpg --to cmyk

# Reduce colors (quantize)
fgp im colors image.png --count 256

# Make transparent
fgp im transparent image.png --color white --fuzz 10%

# Replace color
fgp im replace-color image.png --from red --to blue

# Extract channel
fgp im channel image.jpg --extract red

Borders & Padding

# Add border
fgp im border image.jpg --size 10 --color black

# Add padding
fgp im pad image.jpg --size 20 --color white

# Extend canvas
fgp im extend image.jpg --size 1920x1080 --gravity center --color "#f0f0f0"

# Round corners
fgp im round image.jpg --radius 20

Composite / Merge

# Overlay images
fgp im composite base.jpg overlay.png --position 100x100

# Blend images
fgp im blend image1.jpg image2.jpg --amount 50%

# Montage (grid of images)
fgp im montage *.jpg --tile 3x3 --geometry 200x200+5+5

# Append images
fgp im append image1.jpg image2.jpg --horizontal
fgp im append image1.jpg image2.jpg --vertical

# Stack with labels
fgp im montage *.jpg --tile 2x --label "%f"

Text & Annotation

# Add text
fgp im text image.jpg --text "Hello World" --position 10x30

# Styled text
fgp im text image.jpg --text "Title" --font "Helvetica-Bold" --size 48 --color white --position center

# Text with background
fgp im text image.jpg --text "Caption" --background black --color white --position bottom

# Draw rectangle
fgp im draw image.jpg --rectangle 100x100+50+50 --color red

# Draw line
fgp im draw image.jpg --line "10,10 100,100" --color blue

Batch Processing

# Convert all images in folder
fgp im batch convert ./images --to webp

# Resize all images
fgp im batch resize ./images --width 800

# Compress all images
fgp im batch compress ./images --quality 80

# Thumbnail all images
fgp im batch thumbnail ./images --size 150x150 --output ./thumbs

# Custom batch with pattern
fgp im batch convert ./photos/*.png --to jpg --quality 90

Sprite Sheets

# Create sprite sheet
fgp im sprite icons/*.png --output sprite.png --css sprite.css

# Sprite with padding
fgp im sprite icons/*.png --output sprite.png --padding 2

Compare / Diff

# Compare images
fgp im compare image1.jpg image2.jpg

# Get difference percentage
fgp im diff image1.jpg image2.jpg

# Visual diff output
fgp im diff image1.jpg image2.jpg --output diff.png

Available Commands

| Command | Description | Example | |---------|-------------|---------| | info | Get image info | fgp im info image.jpg | | convert | Format conversion | fgp im convert image.jpg --to png | | resize | Scale image | fgp im resize image.jpg --width 800 | | thumbnail | Create thumbnail | fgp im thumbnail image.jpg --size 150x150 | | crop | Crop image | fgp im crop image.jpg --size 800x600 | | compress | Optimize/compress | fgp im compress image.jpg --quality 80 | | watermark | Add overlay | fgp im watermark image.jpg --image logo.png | | blur | Blur image | fgp im blur image.jpg --radius 5 | | grayscale | Convert to B&W | fgp im grayscale image.jpg | | rotate | Rotate image | fgp im rotate image.jpg --degrees 90 | | batch | Batch process | fgp im batch resize ./images --width 800 |

Output Formats

• Raster: JPEG, PNG, WebP, AVIF, GIF, BMP, TIFF, ICO
• Vector: SVG, PDF, EPS
• Raw: DNG, CR2, NEF (read only)
• Special: HDR, EXR

Example Workflows

Prepare images for web

# Resize, compress, convert to WebP
fgp im resize photo.jpg --width 1200 | \
fgp im compress --quality 80 | \
fgp im convert --to webp

Create responsive image set

# Generate multiple sizes
for size in 320 640 1024 1920; do
  fgp im resize image.jpg --width $size --output "image-${size}w.webp"
done

Process product photos

# Standardize product images
fgp im batch resize ./products --fill 1000x1000 --background white
fgp im batch watermark ./products --image logo.png --position bottom-right --opacity 30%

Create favicon set

# Generate all favicon sizes
fgp im convert logo.png --to ico --sizes 16,32,48,64,128,256 --output favicon.ico
fgp im resize logo.png --size 180x180 --output apple-touch-icon.png
fgp im resize logo.png --size 192x192 --output icon-192.png
fgp im resize logo.png --size 512x512 --output icon-512.png

Batch optimize uploads

# Compress all uploaded images
fgp im batch compress ./uploads --quality 85 --strip --preset web

Troubleshooting

ImageMagick not found

Error: magick/convert not found in PATH

Install ImageMagick: brew install imagemagick or apt install imagemagick

Unsupported format

Error: no decode delegate for this image format

Your ImageMagick may need additional delegates. Try: brew reinstall imagemagick --with-all

Memory limit exceeded

Error: cache resources exhausted

For large images, increase limits: fgp im config --memory 2GB

Permission denied

Error: Permission denied

Check file permissions and output directory access.

Architecture

• ImageMagick subprocess with persistent connection
• UNIX socket at ~/.fgp/services/imagemagick/daemon.sock
• Job queue for batch operations
• Memory-mapped for large images
• GPU acceleration when available (OpenCL)