Loading repository data…
Loading repository data…
GargantuaX / repository
A high-performance, 100% client-side tool for removing Gemini AI image & video watermarks. Built with pure JavaScript using mathematically precise Reverse Alpha Blending. / 基于 JavaScript 的纯浏览器端 Gemini AI 图像和视频无损去水印工具,使用数学精确的反向 Alpha 混合算法
🔥 Tired of Gemini watermarks? Try the more powerful GPT Image 2 at pilio.ai — free for a limited time.
An open-source tool to remove Gemini watermarks from AI-generated images with high-fidelity, reproducible results on supported outputs. Built with pure JavaScript, the engine uses a mathematically exact Reverse Alpha Blending algorithm instead of unpredictable AI inpainting.
🚀 Looking for the
Online Gemini Watermark Remover (Recommended)? Try geminiwatermarkremover.io — free, no install, works directly in your browser.💡 Got watermarks that Gemini Watermark Remover can't handle? Try the general-purpose AI watermark remover: pilio.ai/image-watermark-remover
| Original Image | Watermark Removed |
|---|---|
[!WARNING] USE AT YOUR OWN RISK
This tool modifies image files. While it is designed to work reliably, unexpected results may occur due to:
- Variations in Gemini's watermark implementation
- Corrupted or unusual image formats
- Edge cases not covered by testing
The author assumes no responsibility for any data loss, image corruption, or unintended modifications. By using this tool, you acknowledge that you understand these risks.
[!NOTE] Note: Disable any fingerprint defender extensions (e.g., Canvas Fingerprint Defender) to avoid processing errors. https://github.com/GargantuaX/gemini-watermark-remover/issues/3
For all users — the fastest and easiest way to remove Gemini watermarks from images:
For Gemini-generated videos with visible watermarks:
Note: Video watermark removal runs entirely in your browser — no files are uploaded to any server.
Use this if you do not want a userscript manager but still want automatic Gemini page integration for previews, copy, and download actions.
The popup includes an "Enable on Gemini" toggle. If Gemini becomes slow, behaves unexpectedly, or you need to troubleshoot the page, turn the toggle off and refresh Gemini.
Chrome Web Store installs update automatically. If the Web Store is not reachable in your network, the matching verified zip (gemini-watermark-remover-extension-v*.zip) remains available from GitHub Releases and the official website download entry for manual unpacked installation.
Current userscript boundaries:
Processing... overlayFor workflows that involve AI coding agents:
skills/gemini-watermark-remover/ contains a packaged Skill that agents can discover and invoke.skills.sh using:pnpm dlx skills add GargantuaX/gemini-watermark-remover --skill gemini-watermark-remover
--agent, --yes, or --copy only if your local setup needs them.node skills/gemini-watermark-remover/scripts/run.mjs remove <input> --output <file>
SKILL.md for agent integration details.For scripting, CI, and local batch workflows, use the direct CLI:
# repo-local
node bin/gwr.mjs remove <input> --output <file>
# installed globally
gwr remove <input> [--output <file> | --out-dir <dir>] [--overwrite] [--json]
If you do not have gwr installed globally, use:
pnpm dlx @pilio/gemini-watermark-remover remove <input> --output <file>
The default CLI file decoder/encoder uses sharp. SDK consumers that only use browser or ImageData APIs do not need it. If you use the CLI file path in your own project, install sharp alongside this package:
pnpm add sharp
This tool targets Gemini's visible watermark (the semi-transparent logo in the bottom-right corner). If your image watermark doesn't match a known Gemini format, or you need to remove other types of image watermarks, try the general-purpose AI watermark remover:
👉 pilio.ai/image-watermark-remover
The repository still keeps a local internal preview harness at /dev-preview.html for single-image comparison, copy, and download verification.
/ now only redirects users toward the official website, the userscript artifact, and the internal preview page.# Install dependencies
pnpm install
# Development build
pnpm dev
# Production build
pnpm build
# Local static serving
pnpm serve
Notes:
/ is now a lightweight entry page that points to the official website, the userscript artifact, and the retained internal preview page./dev-preview.html, is now kept as a static Chinese-only single-image compare harness for local algorithm/UI debugging, and no longer maintains public-facing locale or theme-switching features.pnpm dev / pnpm serve still host the userscript, probe pages, and these static assets.For the repo's fixed-profile workflow on macOS:
# Build the latest userscript
pnpm build
# Start a local dist server if needed
pnpm dev
# Open the fixed Chrome profile with remote debugging enabled
./scripts/open-fixed-chrome-profile.sh --url https://gemini.google.com/app
Notes:
.chrome-debug/tampermonkey-profile9226http://127.0.0.1:7890; disable it with --proxy off if not neededpnpm dev serverpnpm dev starts probing from http://127.0.0.1:4173/ and auto-increments if that port is already occupiedpnpm dev output instead of hardcoding 4173The package root still exposes an SDK, but this path is intended for advanced or internal integration scenarios:
import {
createWatermarkEngine,
removeWatermarkFromImage,
removeWatermarkFromImageData,
removeWatermarkFromImageDataSync,
} from '@pilio/gemini-watermark-remover';
Use the pure-data API when you already have decoded ImageData:
const result = await removeWatermarkFromImageData(imageData, {
adaptiveMode: 'auto',
});
console.log(result.meta.decisionTier);
Use the browser image API when you have an HTMLImageElement or HTMLCanvasElement:
const { canvas, meta } = await removeWatermarkFromImage(imageElement);
document.body.append(canvas);
console.log(meta.applied, meta.decisionTier);
If you need to process many images, reuse a single engine instance so alpha maps stay cached:
const engine = await createWatermarkEngine();
const first = await removeWatermarkFromImageData(imageDataA, { engine });
const second = await removeWatermarkFromImageData(imageDataB, { engine });
For Node.js integrations, use the dedicated subpath and inject your own decoder/encoder:
import { removeWatermarkFromBuffer } from '@pilio/gemini-watermark-remover/node';
const result = await removeWatermarkFromBuffer(inputBuffer, {
mimeType: 'image/png',
decodeImageData: yourDecodeFn,
encodeImageData: yourEncodeFn,
});
Float32Array, Uint8ClampedArray)navigator.clipboard.write(...) and ClipboardItem