ViceroyWhirl/Gemini-Config-Checker-

What it does

Google decides whether AI Studio and Gemini are available per signed-in account, so a plain HTTP probe reports every live proxy as healthy even when the region is blocked. Gemini Config Checker tests configs the way a user would: it launches Chrome, Edge or Brave in a separate profile, signs in to Google, opens AI Studio and Gemini, and reads the actual result. Configs that get blocked are marked, and the app distinguishes an AI Studio redirect to the available-regions page from the Gemini country notice.

Two modes share one switch. Simple tests the configs you already have. Advanced takes one working base config and chains free configs behind it, so you get other exits when your Cloudflare route connects but Google rejects its location. Both modes export share links, base64 subscriptions or a ready Xray config.

Install

Use the build for your platform from Releases: Windows amd64/arm64, a macOS universal app, Linux amd64, an Android arm64 APK, or a web server binary that serves the UI on localhost. Releases include SHA256SUMS.txt, and the desktop builds are unsigned, so SmartScreen or Gatekeeper warnings have to be bypassed manually (see the install instructions).

On Linux the desktop build needs GTK 3 and WebKitGTK 4.1; on Windows, WebView2. If no desktop environment is available, use the web server build instead and open http://localhost:8787.

Quick start

1. Start the app (or the web server) and pick Simple to check configs you already have.
2. Paste one config per line (vless://, vmess://, trojan://, ss://), a subscription URL or base64 text, or leave the box empty to scan a ready-made free list.
3. Click Sign in with Google. A separate browser profile opens; sign in normally and the window closes when the app detects it.
4. Press Start scan (Ctrl+Enter). In the Results tab, Healthy means your chosen rule passed, Region blocked shows which product was refused, and Ping is the latency through the route.
5. Copy a share link into your client, or use the Export tab to save a full Xray config.

The detailed walkthrough, including the Advanced chaining flow, is in the user guide.

Constraints

• The region check needs a signed-in Chrome, Edge or Brave; without one, switch to connectivity only, which proves reachability but does not verify the region. The Android app is connectivity-only because it cannot drive a signed-in Chromium.
• The README describes version 0.1.0 as an early pre-release run end to end only on Windows; macOS, Linux and Android builds come from CI and had not been tested on real devices at the time of writing.
• A verdict is a sample. Cloudflare Worker exits can change between connections, so a config that passes now may fail a minute later.
• The anti-DPI profile (fragmenting, unsafe fingerprint, http/1.1 ALPN, cipher list) exists for filtered networks and adds latency elsewhere; only fragment masks are supported.
• The web UI has no authentication, so keep it on localhost rather than exposing it.
• The README's license section says MIT, while the repository metadata says Apache-2.0; check the LICENSE file before redistributing.
• Free configs are run by unknown third parties; traffic content is visible to their operators.

HotRepo's take

The repository appeared on the new-project list on 2026-11-15, gaining 192 stars in roughly one hour of tracked activity, and has no recorded GitHub daily all-language rank. That is a very short signal — one snapshot cannot say whether the interest holds. The project's value depends on a narrow test: the region check relies on a real signed-in Chrome session and on sampling configs whose exits fluctuate, so the result is inherently partial. The combination of a signed-in browser check with chain building for free configs is what distinguishes it from a simple connectivity probe.