doubao-watermark-remover

name	doubao-watermark-remover
description	Remove the visible Doubao (豆包) AI watermark from images. Use when asked to remove Doubao watermarks, clean Doubao-generated images, or process images with the "豆包AI生成" watermark.

Doubao Watermark Remover

Dependencies

• Python 3.9+
• Pillow (install with pip install -r requirements.txt)

Quick start

1. Install dependencies in the scripts folder:

   • cd doubao-watermark-remover/scripts && pip install -r requirements.txt

2. Run the CLI:

   • python remove_watermark.py <input-image> <output-image>

CLI usage

• Parameters:
  • input-image: path to the Doubao watermarked image
  • output-image: path for the cleaned image (format inferred from extension)

Example:

python remove_watermark.py ./in.png ./out.png

What this skill provides

• scripts/remove_watermark.py: CLI entry point and core algorithm.
• scripts/capture_alpha_map.py: Tool to capture Doubao watermark alpha map.
• references/algorithm.md: Math, detection rules, and usage guide.

Workflow

1. First time: Generate alpha map using capture_alpha_map.py
2. Use remove_watermark.py for batch processing.

Capturing Alpha Map (First Time Required)

Since Doubao watermark pattern may vary, you need to capture the alpha map first:

1. Generate a pure black image (0,0,0) and have Doubao add watermark to it

2. Run the capture tool:

   python capture_alpha_map.py <black-with-watermark.png> <width> <height>
   

   Size options: 140x35 (small images) or 180x40 (large images)

3. The tool will save the alpha map to assets/ folder

Notes

• Doubao watermark "豆包AI生成" appears in the bottom-right corner
• Script uses Pillow for image IO and per-pixel edits
• Output format is inferred from the output file extension