Watermark Remover#

Automatically detects watermarks in image corners and removes them using LaMa AI model.

Installation#

This skill requires the watermark-remover Python package. Install it first:

bash

# Install from PyPI (when published)
pip install watermark-remover

# Or install from source
git clone https://github.com/yourusername/watermark-remover.git
cd watermark-remover
pip install -e .

Dependencies: Python 3.9+, opencv-python, numpy, Pillow, iopaint

Script Directory#

Scripts in scripts/ subdirectory. Replace ${SKILL_DIR} with this SKILL.md's directory path.

ScriptPurposescripts/main.pyWatermark removal CLI wrapper

Usage#

bash

python ${SKILL_DIR}/scripts/main.py <input> [options]

Options#

OptionDescriptionDefault<input>Image file or directoryRequired--outputOutput path<input>/no_watermark``--corner-ratioCorner area ratio (0-1)0.15--thresholdDetection sensitivity (lower = more sensitive)30--paddingMask dilation pixels10--previewGenerate mask preview onlyfalse--no-lamaUse OpenCV instead of LaMafalse

Examples#

bash

# Single image
python ${SKILL_DIR}/scripts/main.py image.jpg

# Directory with custom output
python ${SKILL_DIR}/scripts/main.py ./photos/ --output ./cleaned/

# Preview detection (shows red marks on watermarks)
python ${SKILL_DIR}/scripts/main.py ./photos/ --preview

# Adjust detection sensitivity
python ${SKILL_DIR}/scripts/main.py image.jpg --corner-ratio 0.2 --threshold 20

# Use OpenCV inpaint (faster but lower quality)
python ${SKILL_DIR}/scripts/main.py image.jpg --no-lama

How It Works#

1. Scans image corners (default 15% area)
2. Detects watermarks using edge detection + high-frequency analysis
3. Generates precise mask
4. Removes watermark using LaMa AI model (auto-downloads on first run)
5. Falls back to OpenCV inpaint if LaMa fails

Supported Formats#

JPG, JPEG, PNG, BMP, TIFF, WEBP