mcpField
D
doubao-watermark-remover

doubao-watermark-remover

github.com/zhengsuanfaCreative & media31232 installsUpdated 38w ago
Repository

About doubao-watermark-remover

A Python CLI skill for removing the bottom-right “豆包AI生成” watermark from Doubao images. It captures an alpha map before processing and uses Pillow for image edits.

Key features

  1. 01Capture a watermark alpha map
  2. 02Remove watermarks from images
  3. 03Batch image processing
  4. 04Infer output format from extension

Use cases

  1. 01Preparing Doubao images without the watermark
  2. 02Processing multiple watermarked images
  3. 03Creating an alpha map for a watermark pattern

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zhengsuanfa/doubao-watermark-remover --skill doubao-watermark-remover

After installing, type/doubao-watermark-removerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
references/
algorithm.md
scripts/
requirements.txt
capture_alpha_map.py
remove_watermark.py

Details

From the project README

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

Comments

Markdown supported