Local CLI for Gemini images
Gemini Watermark Remover CLI
Remove the visible Gemini logo watermark from files and folders without uploading images. The CLI uses the same reverse alpha restoration engine as the browser tool, wrapped for repeatable terminal work.
pnpm dlx @pilio/gemini-watermark-remover remove in.jpg --output out.png
Quick start
Use pnpm dlx for a one-off run, pass a folder for batch export, 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 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.
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 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 the visible Gemini logo watermark from local image files, so you can run the same engine from scripts and terminals.
Can I batch remove Gemini watermarks from a folder?
Yes. Pass a directory as the input and use --out-dir to export cleaned files into another directory. The CLI keeps the original files separate unless you explicitly choose an output path that replaces something.
Do my images get uploaded?
No. The removal process runs locally on your machine. If you use pnpm dlx, pnpm downloads the package, but the image 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.