WindowStaffGate11/Gemini-Config-Checker-

What it does

Gemini Config Checker is a desktop/web/Android utility for testing proxy configurations (vless, vmess, trojan, ss, subscription URLs or base64 lists) to see which ones actually reach Google AI Studio and Gemini without a region wall. Instead of a plain HTTP probe, which the README argues is unreliable, it opens AI Studio and Gemini in a separate browser profile where you are signed in and reads the region verdict Google shows (why a signed-in browser).

The tool has two modes. Simple tests a batch of configs directly. Advanced takes one working base config and chains free configs behind it, useful when your Cloudflare-based config connects but Google blocks its exit. It also includes an optional anti-DPI profile derived from the patterniha/PattN recipe: TLS ClientHello fragmentation, a fixed fingerprint, ALPN and cipher-suite defaults, and an optional clean IP (anti-DPI profile). Results can be exported as share links, base64 subscriptions or full Xray JSON configs, with a target option that includes or strips the finalmask fork extension.

The app is built on Xray-core and Wails, with a Go engine and a shared single-page UI across desktop, web-server and Android builds (project layout).

Getting started

The documented path is to download a build from the Releases page and unzip/install it (Download and install). On Windows, run GeminiConfigChecker.exe; on Linux install libgtk-3-0 and libwebkit2gtk-4.1-0, then run the extracted binary; the web-server binary serves the same UI at http://localhost:8787.

On first start, choose Simple or Advanced, paste configs one per line (vless://, vmess://, trojan://, ss://) or a subscription URL, and either click Sign in with Google for region checking or switch the check type to connectivity only. Then press Start scan; the Results tab fills with healthy, region-blocked or error states and ping values (user guide).

Advanced mode needs a working base config first; the app verifies it before testing chained free configs.

Constraints

Region checking requires Chrome, Edge, Brave, Chromium or another detectable Chromium browser and launches it in a separate profile; the README recommends a secondary Google account because many IPs may trigger suspicious sign-in notices. Android cannot drive a signed-in browser, so the APK only supports connectivity checks. Sizes are bounded by defaults such as 60 configs and 4 simultaneous browser checks (about 200 MB RAM each), all adjustable in settings (settings reference).

The build matrix says macOS, Linux and Android artifacts come from CI but have not been exercised on real devices, while Windows is the only platform actually run so far. The web server has no authentication and should stay on localhost or behind an SSH tunnel. The README warns that a verdict is a sample of a volatile exit, and that free configs are run by unknown third parties. Builds are unsigned, so SmartScreen/Gatekeeper prompts are expected. The README claims MIT licensing, while bundled Xray-core and fonts keep their own licenses (license).

HotRepo's take

HotRepo's only record is a 2026-11-15 new-project snapshot: 276 stars gained in roughly 1.5 hours of observation, with a star count of 276 and zero forks. There is no GitHub daily rank and no discussion thread, so this is a single short burst rather than a trend. The repository is a fork-style early pre-release whose README explicitly states Windows is the only platform exercised, while the distribution also points to a third-party Dropbox archive. The stars in this window therefore say little about whether the checks work across platforms.