Gemini Watermark Remover CLI

Batch clean folders of Gemini or Nano Banana image outputs without dragging files into a browser one by one. The latest CLI also routes .mp4, .webm, and .mov inputs into a local video cleanup workflow for repeatable terminal and CI work.

View quick start commands Use online tool

Quick start

Use pnpm dlx for a one-off image or video run, batch clean a folder with --out-dir, or install the shorter gwr command when this becomes part of your routine.

Run one file

Clean one Gemini image and write the result to a chosen path.

pnpm dlx @pilio/gemini-watermark-remover remove in.jpg --output out.png

Export a folder

Process every file in a directory and keep output separate.

pnpm dlx @pilio/gemini-watermark-remover remove ./images --out-dir ./clean

Process a local video

Route a supported Gemini video through the local video watermark cleanup flow.

pnpm dlx @pilio/gemini-watermark-remover remove gemini.mp4 --output clean.mp4

Install the gwr command

Install once when you want shorter commands for daily use.

pnpm add -g @pilio/gemini-watermark-remover gwr remove ./images --out-dir ./clean

Use the CLI when repetition matters

The browser tool is still best for a quick manual image. The CLI is for work you want to repeat, check, and hand to a script.

Local batch cleanup

Point the command at a directory and export cleaned images without dragging files into a browser one by one.

Automation-friendly output

Use --json for structured results and predictable exit codes in CI, release scripts, or local jobs.

No upload processing

Image processing happens on the machine running the command. pnpm may fetch the package, but your images are not sent to a service.

Local video cleanup

Pass .mp4, .webm, or .mov files to the same remove command when you need a local Gemini video cleanup workflow.

Common commands

Copy the command closest to your job: one output file, a cleaned directory, or machine-readable automation logs.

Save a cleaned PNG

pnpm dlx @pilio/gemini-watermark-remover remove gemini.png --output clean.png

Clean a folder into a new directory

pnpm dlx @pilio/gemini-watermark-remover remove ./gemini-images --out-dir ./watermark-free

Clean a local video

pnpm dlx @pilio/gemini-watermark-remover remove gemini.mp4 --output clean.mp4

Replace existing outputs and return JSON

pnpm dlx @pilio/gemini-watermark-remover remove ./gemini-images --out-dir ./clean --overwrite --json

CLI FAQ

What do I need to run the CLI?
Node 18+ and pnpm. Tested on Windows, macOS, and Linux. No GPU, no external service.
What is the Gemini Watermark Remover CLI?
It is the command line version of Gemini Watermark Remover. It removes visible Gemini logo watermarks from local image files and now includes a local video cleanup path for supported Gemini video files.
Should I use the CLI or the online remover?
Use the CLI for folders, repeatable local jobs, video files, or CI automation. Use the online remover when you only need to clean a few images by hand.
How do I batch clean a folder with pnpm dlx?
Run pnpm dlx @pilio/gemini-watermark-remover remove ./images --out-dir ./clean. The CLI keeps the original files separate unless you explicitly choose an output path that replaces something.
Can the CLI remove Gemini watermarks from videos?
Yes. The latest CLI detects .mp4, .webm, and .mov inputs and routes them through the video workflow. Use an explicit output video path such as clean.mp4.
Do my images get uploaded?
No. The removal process runs locally on your machine. If you use pnpm dlx, pnpm downloads the package, but your media files are processed on your device.
Does it work in CI?
Yes. Use pnpm dlx for zero-install runs, --out-dir for batch outputs, --overwrite when a job should replace previous results, and --json when a pipeline needs structured output.
Which output formats can I write?
The CLI writes the output format from the file extension. Use .png for PNG, .jpg or .jpeg for JPEG, and .webp for WebP.
Does it remove SynthID or invisible watermarks?
No. It targets the visible Gemini logo watermark in supported Gemini outputs only. It does not remove invisible SynthID signals or unrelated watermarks.

Wire it into your pipeline

Pin a version, log JSON output, and let cleanup run alongside builds. The online tool stays available for one-off images.

Open online tool View source