remove-background-batch

Files (1)

• SKILL.md

SKILL.md (first lines)

# Remove Background (Batch)

Recursively or non-recursively processes multiple images in a directory. Runs `quick-rmbg` per file, with optional parallelism, and prints a summary of successes and failures.

## When to use

- Directory contains 2+ images to strip backgrounds from
- User wants one-shot processing without looping manually
- Output reporting and skip-logic (existing `-nobg.png` files) is useful

## Inputs to gather

- Directory path — folder containing images
- File glob (optional, default: `*.{jpg,jpeg,png,webp}`)
- Mode — `single` (single-pass, default) or `two-pass`
- Max parallel jobs (optional, default: 1 — set higher for multi-core if GPU supports batching)
- Force flag — skip existing `-nobg.png` siblings or re-process them (default: skip)

## Procedure

1. Verify `quick-rmbg` is on PATH.
2. Expand the glob pattern (or default) within the directory.
3. For each file: check if `<filename>-nobg.png` exists; skip unless `--force` is set.
4. Invoke `quick-rmbg $MODE "$file"` (where `$MODE` is empty or `--two-pass`), optionally in parallel (GNU parallel, xargs, or sequential loop).
5. Capture exit code and any stderr for each file.
6. Print per-file outcome: `<filename> … OK | FAIL <error>`.
7. Print summary: `X succeeded, Y failed, Z skipped`.

## Output / side effects

- Creates `<filename>-nobg.png` for each processed file in the same directory.
- Prints progress and summary to stdout.

## Safety / constraints

- Parallelism can overload GPU memory; default to 1 or ask before raising concurrency.
- Skips are reported; clarify if user wants to force re-process.

From danielrosehill/Claude-Background-Removal-Plugin, MIT.

More from danielrosehill/Claude-Background-Removal-Plugin