UniteSupporter/Gemini-Config-Checker-

What it does

Gemini Config Checker is a desktop and server tool that scans proxy configurations and reports which ones let a user reach Google AI Studio and Gemini from a supported region. The core idea is that Google decides availability per signed-in account, so plain HTTP probes give misleading results; the tool instead drives an isolated Chrome/Edge/Brave profile, signs in, and reads what Google actually shows: a redirect to /docs/available-regions for AI Studio, or a country-not-supported message for Gemini (why a signed-in browser).

It ships as a Wails desktop app, a local web UI, and an Android APK. Two modes cover different workflows: Simple checks a pile of configs or a ready-made free list; Advanced chains free configs behind one working base config to get different exits. The engine parses vless://, vmess://, trojan://, ss://, subscription URLs and base64, and can apply an anti-DPI fragmenting profile taken from the PattN recipe (anti-DPI profile).

Quick start

1. Download the build for your platform from Releases; releases include SHA256SUMS.txt.
2. On Windows, unzip and run GeminiConfigChecker.exe (WebView2 is built into Windows 10/11). On Linux, install libgtk-3-0 and libwebkit2gtk-4.1-0 first. On macOS, right-click the app and choose Open.
3. In the Scan tab, choose Simple mode, paste configs one per line (a subscription URL or base64 text also works), and keep Anti-DPI on only if plain Cloudflare configs do not connect.
4. Click Sign in with Google and complete sign-in in the separate browser window that opens; the app detects it and closes the window.
5. Press Start scan and watch the Results tab. Each config gets Healthy, Region blocked or Error, with per-product AI Studio and Gemini columns and a ping value.
6. Copy the share link or export a ready-to-import Xray config from the Export tab; choose the PattN variant if the client supports finalmask, otherwise the standard variant removes it.

For a browserless setup, switch the check type to connectivity only, which proves reachability but does not verify region (settings reference). The web server build runs on http://localhost:8787 and exposes the same UI (web server).

Constraints

• Region checking requires a Chromium-based browser the app can locate; Flatpak browsers cannot be driven, and busier machines may need fewer simultaneous browser checks since each uses about 200 MB of RAM.
• Android builds run connectivity-only mode; Android does not let the app drive a signed-in Chromium.
• Version 0.1.0 is an early pre-release; only Windows has been exercised end to end, while macOS, Linux and Android builds come from CI and remain untested on real devices.
• Desktop builds are unsigned, so Windows SmartScreen and macOS Gatekeeper will warn. The Android APK may be signed with a throw-away key when no repository key is configured, which prevents in-place upgrades.
• The local web UI has no authentication and should stay on localhost or be tunneled.
• The anti-DPI profile adds latency outside filtered networks.
• A verdict is a sample: Cloudflare Worker exits can change between connections, and the same route may pass and then fail.

HotRepo's take

The repository appeared on HotRepo's new-project list on 2026-11-15 with 192 stars gained in the recorded window and no forks. That is a very short observation period, so it says little about sustained interest. The engineering detail that stands out is the decision to test region availability through a signed-in browser rather than an HTTP probe, which is a meaningful distinction for this kind of tool; the README also explicitly marks the non-Windows builds as untested on real devices, so early adopters on those platforms should expect rough edges.

License

MIT, with the bundled Xray-core and fonts under their own licenses (license).