VisionWormStudio/Gemini-Config-Checker-

What it does

Gemini Config Checker tests proxy configs the way a person would use them: it opens a signed-in browser session and checks whether AI Studio and Gemini accept the exit region, rather than relying on a plain HTTP probe. According to the project, plain requests answer "fine" from every country, so they cannot distinguish a working route from a region-blocked one; the tool therefore reads Google's own verdict, such as a redirect to the available-regions page for AI Studio or the unsupported-country notice for Gemini Why a signed-in browser.

It has two modes. Simple checks a pile of configs you already have (links, subscription URL, or base64). Advanced chains free configs behind a working base config, which helps when a Cloudflare config connects but Google rejects its exit. The UI ships as a native desktop app, a local web server, and an Android app (connectivity checks only). The proxy engine is Xray-core, and the anti-DPI defaults come from the patterniha/PattN recipe credits.

Getting started

Prebuilt binaries are published on the Releases page, with SHA256SUMS.txt for each release. On Windows, unzip the desktop build and run GeminiConfigChecker.exe; the build is unsigned, so SmartScreen may warn. macOS users need to right-click the app and choose Open on first launch, and Linux needs libgtk-3-0 and libwebkit2gtk-4.1-0 installed. The web server build starts on http://localhost:8787 with ./gemini-config-checker and is the option for headless machines.

Once the app opens:

1. Keep the mode on Simple if you only want to know which existing configs work.
2. Paste one config per line (vless://, vmess://, trojan://, ss://), or leave the box empty to test a ready-made free list.
3. Click Sign in with Google; a separate browser profile opens, and the sign-in is remembered in the app's own profile. Alternatively switch the check type to connectivity only.
4. Press Start scan and watch the Results tab. Filter or sort the rows, then use the Export tab to copy links, a base64 subscription, or an Xray config.

For Advanced mode, provide a base config that works and does not hit the region wall, then choose a free-config source; the app tests the base first and stops if it cannot reach Google.

Constraints

Region checks need Chrome, Edge, or Brave, and use about 200 MB per concurrent browser check; the default limit is four, with a 20-way connectivity pre-check first. A full scan of 60 configs in region mode takes 20–40 seconds per config. Android runs connectivity-only because apps cannot drive a signed-in Chromium there, so the region is not verified on that platform. The desktop builds are unsigned. The local web UI has no authentication and should stay bound to localhost or be reached through an SSH tunnel. Free configs are operated by unknown third parties, so sensitive traffic should not be sent through them. The repository is licensed MIT, while the bundled Xray-core and fonts keep their own licenses license.

HotRepo's take

The repository was recorded on the New list on 2026-11-15 with 192 stars gained in roughly one hour, and no GitHub daily rank has been recorded for it. That single snapshot only establishes a fast opening burst; it says nothing about whether the tool's scan results hold up in practice. The README is unusually detailed about its checking method and platform caveats, but the source tree is Go with no recorded release history in the HotRepo data, so the practical question for readers is whether the prebuilt binaries match the repository. The project itself notes that a verdict is a sample, since a Cloudflare Worker's exit can change between connections and a route may pass now and fail a minute later reading the results. That caveat is the most useful thing to keep in mind when acting on a scan.

One thing worth flagging: the README's top banner links to a Dropbox-hosted .rar download, separate from the GitHub Releases the install section describes. The install instructions and checksums point to Releases, so treat the Dropbox file as unverified third-party distribution rather than the documented release channel.