Watermark Remover CLI
Remove visible Gemini logo and Veo text watermarks from files and folders without uploading. The CLI uses the same reverse alpha restoration engine as the browser tool, wrapped for repeatable terminal work.
$ npx @vylio/gemini-veo-watermark-remover remove image.png --output clean.png
$ npx @vylio/gemini-veo-watermark-remover remove video.mp4 --verbose
Quick start
Use npx for a one-off run, batch clean a folder with --out-dir, or install the shorter vwr command for daily use.
Run one file
Clean one Gemini image or Veo video and write the result to a chosen path.
npx @vylio/gemini-veo-watermark-remover remove in.jpg --output out.png Export a folder
Process every file in a directory and keep output separate.
npx @vylio/gemini-veo-watermark-remover remove ./images --out-dir ./clean Install the vwr command
Install once when you want shorter commands for daily use.
npm i -g @vylio/gemini-veo-watermark-remover
vwr 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 files without dragging them 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
Processing happens on the machine running the command. Your files are never sent to a service.
Common commands
Save a cleaned PNG
npx @vylio/gemini-veo-watermark-remover remove gemini.png --output clean.png Process a Veo video
npx @vylio/gemini-veo-watermark-remover remove veo-clip.mp4 --output clean.mp4 --verbose Replace existing outputs and return JSON
npx @vylio/gemini-veo-watermark-remover remove ./images --out-dir ./clean --overwrite --json CLI FAQ
What do I need to run the CLI?
Node 18+ and npm or pnpm. Tested on Windows, macOS, and Linux. No GPU or external service required.
Does it support both images and videos?
Yes. The CLI detects file type by extension and routes to the Gemini image engine or Veo video engine automatically.
Do my files get uploaded?
No. The removal process runs locally on your machine. npm downloads the package, but your files are processed on your device.
Does it work in CI?
Yes. Use npx for zero-install runs, --out-dir for batch outputs, --overwrite when a job should replace previous results, and --json for structured output.
Which output formats can I write?
The CLI writes the output format from the file extension. Use .png for PNG, .jpg for JPEG, .webp for WebP, and .mp4 for video.
Does it remove SynthID or invisible watermarks?
No. It targets visible Gemini logo watermarks and Veo text watermarks only.
Wire it into your pipeline
Pin a version, log JSON output, and let cleanup run alongside builds.