Blur — Image Blur & Privacy Mask Tool

A comprehensive image processing skill for applying blur effects, face detection with automatic masking, region-based redaction, and batch processing. All processing metadata is tracked in JSONL format.

Prerequisites

• bash (v4+)
• python3 (v3.6+)
• Pillow (PIL) — Python image library (install via pip3 install Pillow)
• Optional: face detection libraries for the face command

Environment Variables

Data Storage

• Metadata: ~/.blur/data.jsonl
• Config: ~/.blur/config.json
• Output directory: ~/.blur/output/

Commands

apply

Apply blur effect to an entire image.

BLUR_INPUT="/path/to/image.jpg" BLUR_RADIUS="15" BLUR_TYPE="gaussian" scripts/script.sh apply

face

Detect and blur faces in an image for privacy.

BLUR_INPUT="/path/to/photo.jpg" BLUR_RADIUS="20" scripts/script.sh face

region

Blur a specific rectangular region in an image.

BLUR_INPUT="/path/to/image.jpg" BLUR_REGION="100,50,200,150" scripts/script.sh region

batch

Process multiple images in a directory.

BLUR_DIR="/path/to/images/" BLUR_RADIUS="10" scripts/script.sh batch

preview

Generate a low-resolution preview of the blur effect.

BLUR_INPUT="/path/to/image.jpg" BLUR_RADIUS="10" scripts/script.sh preview

undo

Revert a blur operation using the original backup.

BLUR_ID="blur_abc123" scripts/script.sh undo

config

View or update blur configuration.

BLUR_KEY="default_radius" BLUR_VALUE="15" scripts/script.sh config

export

Export processing history.

BLUR_FORMAT="json" scripts/script.sh export

list

List all processed images.

scripts/script.sh list

status

Show processing statistics.

scripts/script.sh status

help

Display usage information.

scripts/script.sh help

version

Display current version.

scripts/script.sh version

Output Format

{
  "status": "success",
  "command": "apply",
  "data": {
    "id": "blur_20240101_abc123",
    "input": "/path/to/image.jpg",
    "output": "/path/to/image_blurred.jpg",
    "blur_type": "gaussian",
    "radius": 10
  }
}

Error Handling

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com