Visionbeyondtrack/Gemini-Config-Checker-

What it does

Gemini Config Checker evaluates proxy configurations by opening Google AI Studio and Gemini in a browser profile that is actually signed in, rather than just pinging an endpoint. The project argues that plain HTTP requests report success from every country, while Google applies region rules per signed-in account after the page loads; blocked AI Studio access shows up as a redirect to /docs/available-regions, and blocked Gemini access shows as a country-not-supported message (why a signed-in browser).

It has two modes. Simple tests your own configs (share links, subscription URLs, base64) directly. Advanced chains free configs behind a working base config, so you can obtain a different exit when Google rejects the base config's exit. An optional anti-DPI profile applies the fragmentation/TLS settings described by the PattN recipe, with editable values and an in-app forwarder for per-segment fragment masks that stock Xray-core does not support.

Outputs are share links, base64 subscriptions, or full Xray config JSON; advanced mode can export a base → free chain.

Quick start

1. Download the build for your platform from the Releases page. Windows and macOS builds are unsigned; on macOS, launch via right-click → Open, or remove the quarantine attribute if Gatekeeper still refuses.
2. On Linux, install the runtime libraries once: sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0, then extract the tarball and run ./GeminiConfigChecker. Without a desktop environment, use the web server binary and open http://localhost:8787 (web server details).
3. Open the Scan tab, paste one config per line (vless://, vmess://, trojan://, ss://), and press Start scan (or Ctrl+Enter). Leaving the box empty tests a ready-made free list.
4. For region checks, click Sign in with Google; the app opens an isolated Chrome/Edge/Brave profile, and closes it when sign-in is detected. If no supported browser is available, switch the check type to connectivity only.
5. Review the Results tab and use Copy or Copy with chain for the config you want to keep.

Detailed steps for advanced mode and exports are in the user guide.

Constraints

• Region checking requires Chrome, Edge, Brave, or Chromium; Flatpak browsers cannot be driven. Android runs connectivity-only mode because apps cannot drive a signed-in Chromium.
• Region checks take roughly 20–40 seconds per config. The default limit is 60 configs, and each simultaneous browser check uses about 200 MB of RAM.
• A verdict is a sample: Cloudflare Worker exits can change between connections, so a config may pass now and fail later; retest before relying on it.
• Anti-DPI settings target filtered networks and add latency elsewhere; turn the profile off outside such networks.
• The web server has no authentication. Keep it on 127.0.0.1 or tunnel it rather than exposing it.
• The repository advertises a Dropbox .rar download labeled "Gemini app" at the top of the README (download link), which does not match the documented build and release process; prefer the signed release artifacts with SHA256SUMS.txt.
• The README says version 0.1.0 is an early pre-release tested only on Windows; macOS, Linux, and Android builds have not been exercised on real devices.
• The README states the MIT license (license), though the repository metadata shows Apache-2.0; the bundled Xray-core and fonts keep their own licenses.

HotRepo's take

The project appeared on HotRepo's new-project list on 2026-11-15, gaining 192 stars in the recorded hour-long window. That is a very short observation window, and no GitHub daily rank is recorded, so it is not evidence of sustained adoption. The technical premise is specific and testable—reading Google's post-login region response instead of pinging endpoints—and the README documents the limitations of connectivity-only mode and of sampling exits. The unauthenticated web UI and unsigned binaries are the main practical risks to weigh before running it.