Updatedelcure/Gemini-Config-Checker-

What It Does

Gemini Config Checker tests whether a proxy configuration actually gets a signed-in Google account into Google AI Studio and Gemini. The README argues that a plain HTTP request to the Gemini API answers "fine" from any country, so connectivity pings mark every live config as healthy; the reliable signal is what Google shows a signed-in user — an AI Studio redirect to /docs/available-regions, or the "Gemini isn't currently supported in your country" message in Gemini (Why a signed-in browser).

The app wraps Xray-core in a native desktop shell via Wails and ships the same engine as a web server and an Android APK. It supports vless://, vmess://, trojan:// and ss:// share links, subscription URLs and base64 text, and exports links, base64 subscriptions or full Xray JSON configs.

Two modes cover different questions:

Mode	Route	Typical use
Simple	you → config → Google	find which of your configs work
Advanced	you → base config → free config → Google	your Cloudflare config connects but Google blocks its exit

An anti-DPI profile applies TLS ClientHello fragmentation and the settings from the referenced PattN recipe; the README says it is intended for filtered networks and only adds latency elsewhere (anti-DPI profile).

Getting Started

1. Download the build for your platform from Releases. Windows users unzip gemini-config-checker-desktop_<version>_windows_amd64.zip and run GeminiConfigChecker.exe; the build is unsigned, so SmartScreen may require More info → Run anyway.
2. Linux desktop needs GTK 3 and WebKitGTK 4.1 (sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 on Debian/Ubuntu), or use the web server build and open http://localhost:8787.
3. Open the app and choose Simple or Advanced. In Simple mode, paste configs one per line, or leave the box empty to use a ready-made free list.
4. For a region check, click Sign in with Google. A separate browser profile opens; the app never sees your password, and you are advised to use a secondary account because requests come from many IPs.
5. Press Start scan and watch the Results tab. Region checks take 20–40 s per config; connectivity-only mode is faster but does not verify the region.
6. Copy a working link into your client, or export a full Xray config for PattN/PattNG (with finalmask) or stock Xray/v2rayN.

A setup walkthrough with per-mode steps is in the user guide; build requirements and make targets are documented in Build from source.

Constraints

• Region checking requires Chrome, Edge, Brave or Chromium; Flatpak browsers cannot be driven. Android only supports connectivity mode because apps cannot drive a signed-in Chromium.
• The README states the version is 0.1.0 and early pre-release, tested end to end only on Windows; macOS, Linux and Android builds come from CI and have not been exercised on real devices.
• The web server has no authentication; it binds to 127.0.0.1 by default and should not be exposed directly.
• A verdict is a sample, not a guarantee: Cloudflare Worker exits can change between connections, so a config that passed may fail later.
• Free configs are operated by unknown third parties; the README warns against sending sensitive traffic through them.
• The repository is Apache-2.0, while the bundled Xray-core and fonts keep their own licenses.

HotRepo's take

The repository appeared on HotRepo's new-project board on 2026-11-15, gaining 192 stars within roughly one hour of the tracked window — a fast first-day rise, but with only a single snapshot there is no basis to describe a trend. The concept is narrow and concrete: instead of pinging an endpoint, it reads Google's own region wall in a signed-in browser, and it documents that behavior against the AI Studio and Gemini error pages. The weak point is delivery trust: the release channels include an unsigned Windows executable and a separate Dropbox-hosted RAR at the top of the README, and the README only addresses signing for Android. Readers evaluating this project should weigh the region-checking idea against that distribution picture.