VoltAshSpace/Gemini-Config-Checker-

What it does

Gemini Config Checker tests proxy configurations (VLESS, VMess, Trojan, Shadowsocks, subscription URLs or base64 lists) and reports which ones actually reach Google AI Studio and Gemini. Because Google decides region availability per signed-in account after the page loads, plain HTTP probes report success from every country; the tool instead drives a Chrome, Edge or Brave profile to sign in and read the real region verdict: a redirect to AI Studio's available-regions page, or Gemini's unsupported-country message. The proxy engine is Xray-core, wrapped in a Wails desktop shell with the same Go engine and web UI shared across desktop, server and Android builds.

Modes and anti-DPI

Simple tests each config on its own. Advanced chains free configs behind one working base config so the exit changes while the base stays fixed.

An optional anti-DPI profile applies a TLS ClientHello fragmenting recipe with configurable Finalmask, fingerprint, ALPN, cipher suites and clean IP. The app implements per-segment fragment lengths in a local forwarder because stock Xray-core only supports one length per mask detailed in the profile section.

Quick start

1. Install the build for your system from the releases page. Windows: unzip and run GeminiConfigChecker.exe (unsigned, so SmartScreen needs More info → Run anyway). Linux: sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0, untar, then ./GeminiConfigChecker. Web server: run ./gemini-config-checker and open http://localhost:8787.
2. Open the Scan tab and paste configs one per line, or leave the box empty to use a ready-made free list.
3. Click Sign in with Google so the app can check the region in an isolated browser profile; or switch check type to connectivity only, which skips sign-in and only measures reachability.
4. Press Start scan and read the Results tab; healthy configs show white labels with per-product region columns.
5. Copy the share link or a full Xray config from the Export tab, choosing the PattN variant (keeps finalmask) or the standard Xray/v2rayN variant (strips it).

Build from source with make web, make desktop or make android after installing Go, Wails v2 and the platform webview build notes.

Constraints

• Region checking requires Chrome, Edge, Brave or Chromium and is not available on Android, which only supports connectivity mode.
• Only Windows has been exercised end to end; macOS, Linux and Android builds come from CI and are untested on real devices per the README's pre-release note.
• Each simultaneous browser check uses roughly 200 MB RAM; default cap is 60 configs and 4 browser checks.
• The web server has no authentication and should stay bound to localhost or behind an SSH tunnel.
• Desktop and APK builds are unsigned; Android APKs signed with a throw-away key cannot be updated in place.
• Free configs are operated by unknown third parties; a passing verdict is a sample, since Cloudflare Worker exits can change between connections.
• The license is Apache-2.0 per repository metadata, while the README links an MIT LICENSE file; the bundled Xray-core and fonts keep their own licenses.

HotRepo's take

The repository appeared on the new-project list on 2026-11-15 with 192 stars gained in its first recorded hour-long window, and no GitHub daily-rank position has been recorded. That is a single snapshot, not a trend, and it says nothing about whether the checker's region verdicts hold up in practice. The README is unusually detailed for a pre-release: it documents the anti-DPI recipe, a chain-export format, per-platform runtime dependencies and CI behavior, which makes the scope assessable even though only Windows has been run. One inconsistency is worth noting before downloading: the README banner links a Dropbox .rar as the app download while the install section points to GitHub Releases, so confirm the source and the published SHA256SUMS.txt first.