ImageMagick Operations

Comprehensive ImageMagick operations for image manipulation in Moltbot.

Installation

macOS:

brew install imagemagick

Linux:

sudo apt install imagemagick  # Debian/Ubuntu
sudo dnf install ImageMagick  # Fedora

Verify:

convert --version

Available Operations

1. Remove Background (white/solid color → transparent)

./scripts/remove-bg.sh input.png output.png [tolerance] [color]

| Parameter | Default | Range | Description | |-----------|---------|-------|-------------| | input.png | — | — | Source image | | output.png | — | — | Output transparent PNG | | tolerance | 20 | 0-255 | Color matching fuzz factor | | color | #FFFFFF | hex | Color to remove |

Examples:

./scripts/remove-bg.sh icon.png icon-clean.png              # default white
./scripts/remove-bg.sh icon.png icon-clean.png 30           # loose tolerance
./scripts/remove-bg.sh icon.png icon-clean.png 10 "#000000" # remove black

2. Resize Image

convert input.png -resize 256x256 output.png

3. Convert Format

convert input.png output.webp          # PNG → WebP
convert input.jpg output.png           # JPG → PNG
convert input.png -quality 80 output.jpg  # Compress

4. Rounded Corners (iOS style)

convert input.png -alpha set -virtual pixel transparent \
    -distort viewport 512x512+0+0 \
    -channel A -blur 0x10 -threshold 50% \
    output-rounded.png

5. Add Watermark

convert base.png watermark.png -gravity southeast -composite output.png

6. Batch Thumbnail Generation

for f in *.png; do convert "$f" -resize 128x128 "thumbs/$f"; done

7. Color Adjustments

convert input.png -brightness-contrast 10x0 output.png      # brighter
convert input.png -grayscale output.png                     # grayscale
convert input.png -modulate 100,150,100 output.png          # more saturation

Common Patterns

Flat Icon → Transparent Background

./scripts/remove-bg.sh icon.png icon-clean.png 15

Generate App Icon Set (iOS)

for size in 1024 512 256 128 64 32 16; do
    convert icon.png -resize ${size}x${size} icon-${size}.png
done

Optimize for Web

convert large.png -quality 85 -resize 2000x2000\> optimized.webp

Tips

1. Higher tolerance (20-50): Better for anti-aliased edges, may remove some foreground
2. Lower tolerance (5-15): Preserves detail, may leave color fringes
3. For flat icons: 10-20 usually works best
4. Use -quality for JPEG/WebP compression (0-100)
5. Use -strip to remove metadata for smaller files