blur

What This Skill Does

The blur skill is a high-precision image processing toolset designed for the OpenClaw AI agent to handle privacy masking, image redaction, and aesthetic blurs. By utilizing the robust Pillow (PIL) library, it allows users to perform complex visual modifications via simple command-line triggers. The tool supports multiple blur algorithms, including Gaussian, box, and motion blurs, ensuring versatility for both security-focused redaction and artistic photography adjustments. Beyond simple blurring, it features advanced capabilities like automated face detection and masking, which are essential for processing sensitive data or maintaining privacy in social documentation. All operations are meticulously logged in a JSONL file format, allowing for full auditing, history tracking, and the ability to revert changes via the undo command.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/bytesagain/blur. Ensure that your environment has python3 (v3.6+) and Pillow installed. You may also need to install supplemental face detection libraries if you intend to utilize the automated face-masking feature.

Use Cases

• Privacy Protection: Automatically redact faces in photos before uploading them to public platforms or shared network drives.
• Sensitive Information Redaction: Use the region-based blur to obscure personal identifiers, license plates, or confidential document snippets.
• Batch Processing: Quickly apply standardized privacy filters to large image datasets, such as cleaning up a folder of conference snapshots.
• Aesthetic Effects: Generate low-resolution previews or apply motion blurs for artistic portfolio imagery.

Example Prompts

1. "Blur the faces in the image located at /home/user/photos/meeting.jpg using a radius of 25."
2. "Redact the license plate in the bottom left corner of the photo /data/car.png. The coordinates are 50,200,100,50."
3. "Run a batch blur on all images in the /downloads/raw_photos folder with a gaussian blur setting of 10."

Tips & Limitations

• Precision: When using the region command, double-check your x,y,width,height coordinates to ensure you are masking the correct area.
• Storage: Regularly clear your ~/.blur/output/ directory if you process large numbers of high-resolution images to prevent storage bloat.
• Undo Capability: Keep your BLUR_ID records handy, as you cannot revert changes without the specific ID associated with the operation.
• Performance: For batch operations, note that memory usage may increase based on the number of images and their resolution; ensure sufficient system resources are available.