WharfBoulderColander/Gemini-Config-Checker-

What it does

Gemini Config Checker tests proxy configs the way a person would use them: by opening AI Studio and Gemini in a signed-in browser through the route under test, then reading Google's region verdict. Plain HTTP probes ask Google nothing about region, so the README argues they mark every live config as healthy; this tool instead watches for the AI Studio redirect to /docs/available-regions and the "Gemini isn't currently supported in your country" message (why a signed-in browser).

It parses vless://, vmess://, trojan:// and ss:// share links, subscription URLs and base64 lists, optionally applies an anti-DPI fragmentation profile borrowed from the PattN / PattNG work (anti-DPI profile), and reports per-config status and latency. Results can be exported as links, a base64 subscription, or a ready-to-import Xray JSON.

There are two modes. Simple checks a pile of configs you already have. Advanced chains chosen free configs behind a base config that works for you, to find a different exit Google accepts.

Getting started

1. Get a build for your platform from the Releases page; each release publishes SHA256SUMS.txt. The Windows desktop build is a zip containing GeminiConfigChecker.exe (download and install).
2. Launch it and choose Simple or Advanced in the header.
3. Paste configs (one per line), a subscription URL, or base64 text, or leave the box empty to test a bundled free list.
4. Click Sign in with Google once for the region check. The app opens Chrome/Edge/Brave in a separate profile, and sign-in is remembered for that profile.
5. Press Start scan (or Ctrl+Enter) and read the Results tab; use Copy or Copy with chain to move a result into v2rayN, Hiddify, PattN or BPB's Chain Proxy field (user guide).

Desktop-less Linux and server setups can run the web build and open http://localhost:8787 (build from source). Android runs connectivity-only, with the engine kept alive by a foreground notification.

Constraints

• The README calls version 0.1.0 an early pre-release that has only been exercised end to end on Windows; macOS, Linux and Android builds come from CI and are untested on real devices.
• Region checking needs Chrome, Edge, Brave or Chromium on Windows/macOS/Linux. Android cannot drive a signed-in Chromium, so it only confirms connectivity and latency.
• The anti-DPI profile is aimed at filtered networks (notably Iran) and adds latency elsewhere; only fragment masks are supported.
• The web server binds to localhost, rejects foreign Host headers and non-JSON POSTs, but has no authentication (privacy and security).
• Free configs are operated by unknown third parties; the README warns not to send sensitive traffic through them. A verdict is a sample, not a guarantee: Cloudflare Worker exits can change between connections.
• Desktop builds are unsigned, so SmartScreen and Gatekeeper warn; the macOS workaround uses xattr -dr com.apple.quarantine. The Android APK may be signed with a throw-away key, so uninstall before updating.
• The repository's LICENSE is MIT, while the bundled Xray-core and fonts keep MPL-2.0 and SIL OFL licensing (license).

HotRepo's take

The repository appeared on GitHub's new-project list on 2026-11-15 with 293 stars gained in about an hour and a half of the measured window, and no daily all-language rank recorded. That is fast early attention for a 0.1.0 pre-release whose own README says only Windows has been run end to end, so the star count reflects curiosity more than proven cross-platform behavior. The design choice worth watching is the signed-in browser check: it is slower and heavier than a connectivity probe, but it targets the actual failure this audience hits — a route that looks reachable while Google's regional wall still blocks the account.