Nanobanana Watermark CLI

Remove watermarks from images in a file or a folder using a lightweight Bun CLI.

Install

bun install

To add the command to your PATH:

bun link

To remove the linked command:

bun unlink

This project is intended for source/GitHub usage and is not published to npm.

Remove global install:

bun remove -g nanobanana-watermark-cli

If you want to install from source:

git clone https://github.com/bentcc/nanobanana-watermark-cli.git
cd nanobanana-watermark-cli
bun install
bun link

CLI usage

nb-dewatermark <path>

• <path> can be a file or a directory.
• If <path> is omitted, the CLI tries fzf against the current working directory entries. If fzf is not available or you exit it, the CLI prompts for a path instead.

If you prefer to run directly without linking:

bun run src/cli/index.ts <path>

Behavior

• Input path expands ~ to your home directory.
• Directory input is non-recursive and processes files in that folder only.
• Output folder is named no-watermark:
  • For a directory input: <input>/no-watermark
  • For a file input: <file directory>/no-watermark
• Supported extensions (case-insensitive): .png, .jpg, .jpeg, .webp.
• Size cap: images over 100,000,000 pixels are skipped and reported as skipped.
• If no supported images are found, the CLI errors with No supported images found.

Examples

# Process a directory
nb-dewatermark ./images

# Process a single file
nb-dewatermark ./images/photo.jpg

Command discovery (fzf)

If you have fzf installed and want to search for the command name:

compgen -c | fzf --query nb-dewatermark

Tests

bun test

Documentation

• docs/CODEMAPS/INDEX.md

Repository notes

• This is an open GitHub repository for personal use.
• This is an AI-developed project.
• Watermark removal logic is based on https://raw.githubusercontent.com/doggy8088/TampermonkeyUserscripts/main/src/NoWatermarkForNanoBananaPro.user.js.

Contributing

This repository does not accept PRs.