allenk/GeminiWatermarkTool

VEO / Gemini 3.5 Nano Banana Pro watermark maintenance tool

Gemini Watermark Tool – 概要

GeminiWatermarkTool は、Google の Gemini AI モデルによって生成された画像(および、コンパニオンバイナリを介して動画)に付与される可視的なウォーターマークを除去する、軽量なクロスプラットフォーム・プログラムです。汎用的な生成インペインティングではなく、決定論的なリバース・アルファブレンディング アルゴリズムを使用しているため、元のピクセルデータを可能な限り正確に復元できます。オプションの軽量ニューラルネットワーク・デノイザー (FDnCNN) を使用して、残ったアーティファクトをクリーンアップすることも可能です。


主な機能 (README記載)

カテゴリ 詳細
コアアルゴリズム Gemini のウォーターマーク用にキャリブレーションされた 48×48 および 96×96 マスクを使用したリバース・アルファブレンディング。
ウォーターマークプロファイル 新しい Gemini 3.5 レイアウト (36×36 または 96×96 ロゴ) をサポートし、古い 3.5 未満のレイアウトには自動的にフォールバックします。
検出 信頼度スコアリングを伴う 3 ステージの正規化相互相関 (NCC)。ウォーターマークのない画像はスキップされます。
CLI 単一ファイル、バッチディレクトリ、およびマルチファイルモード。自動レガシーフォールバック、設定可能な --threshold--force--legacy、および個別の終了コード (0 = OK, 1 = スキップ, 2 = エラー)。
GUI リアルタイムの前後プレビュー、カスタム領域選択、インペインティング (NS, TELEA, Soft)、AI デノイズ、バッチサムネイル、およびキーボードショートカットを備えたドラッグ&ドロップ対応のデスクトップアプリ。
AI支援クリーンアップ Vulkan GPU 加速を備えた NCNN 経由で実行される FDnCNN (20 層畳み込みネットワーク)。 GPU がない場合は CPU にフォールバック。
動画サポート フレームごとに同じリバース・アルファ計算を適用する、別の VeoWatermarkRemover バイナリ (v0.6.1)。適応型フレーム別アルファ、オーディオパススルー、およびオプションの AI デノイズに対応。
クロスプラットフォーム Windows, Linux, macOS (Intel + Apple Silicon) および Android CLI 用のビルド済みポータブル実行ファイル。
エージェント統合 MCP サーバーおよび Claude Code スキル (gwt-integrations) により、AI エージェント・パイプライン向けに 4 つのツール呼び出し (remove_watermark, detect_watermark, batch_process, get_tool_info) を公開。
ライセンス MIT – 商用利用無料(再配布には帰属表示が必要)。

主なユースケース

  1. Gemini 生成画像のクリーニング: 公開やアーカイブの前に、生成塗りつぶしに頼らずに元の詳細を保持してクリーンアップします。
  2. バッチ処理: 一部のファイルにウォーターマークが含まれていない可能性がある、大量のスクリーンショットや書き出し済みアセットのフォルダを処理します。
  3. 自動化スクリプトへの統合: CLI の終了コードや MCP 経由の API を使用して、CI パイプラインやコンテンツモデレーションボットに組み込みます。
  4. 動画ポストプロセッシング: コンパニオンの VeoWatermarkRemover バイナリを使用して、Gemini 3.5 の「ダイヤモンド」ウォーターマークが含まれる録画を処理します。

クイックスタート (CLI)

# 単一画像、自動検出
GeminiWatermarkTool image.png

# 検出に失敗しても強制的に処理
GeminiWatermarkTool --force image.png -o clean.png

# フォルダごと一括処理 → 出力フォルダ
GeminiWatermarkTool -i./watermarked/ -o./clean/

# レガシープロファイルのみを使用
GeminiWatermarkTool --legacy old_image.png

クイックスタート (GUI)

  1. 実行ファイルを実行します(インストーラーは不要)。
  2. 画像またはフォルダをウィンドウにドラッグ&ドロップします。
  3. ツールがウォーターマークを自動検出します。必要に応じて領域を調整するか、別のプロファイルを選択してください。
  4. X で適用、V で前後表示の切り替え、Z で元に戻すを行います。
  5. 動画の場合は、別の VeoWatermarkRemover バイナリを起動して MP4 ファイルをドロップしてください。

なぜ重要なのか

  • 決定論的な復元: コンテンツを捏造する AI インペインティング ツールとは異なり、この手法はウォーターマークを追加した正確なブレンディングを数学的に逆転させるため、元の画像が変更されていない場合に忠実な復元が可能です。
  • 軽量かつオフライン: オプションの GPU 加速デノイズを備えた単一のポータブル実行ファイルで、クラウドサービスは不要です。
  • 最新対応: 最新の Gemini 3.5 ウォーターマークレイアウトをサポートし、古い画像には自動的にフォールバックします。
  • 拡張性: MCP 経由で公開されているため、将来の AI エージェント (Claude, Cursor など) が直接呼び出すことができます。

詳細情報


まとめ

GeminiWatermarkTool は、Google の Gemini モデルが出力に刻印する独自のウォーターマークを除去するという、非常に具体的な AI 関連の問題に焦点を当てた、真のオープンソース・ユーティリティです。数学的に正確なリバース・アルファ・アルゴリズムとオプションの AI ベースのデノイズを組み合わせ、CLI と洗練された GUI の両方を提供し、さらに AI エージェント統合のための API も提供しています。Gemini 生成メディアをクリーンアップするための信頼できるオフラインの方法を必要とするすべての人にとって、このリポジトリはまさに最適で、すぐに利用可能です。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • Dispatch