WyrmClimberManacle/Gemini-Config-Checker-

What it does

Gemini Config Checker tests proxy configs the way a user would actually use them: it opens AI Studio and Gemini in a browser signed into your Google account and reads whether Google shows the region wall. A plain HTTP probe is not enough, because Google decides availability per account after page load, so a config can look reachable while still being blocked Why a signed-in browser.

It has two modes. Simple tests a list of configs (share links, subscription URL, or base64), each connecting from your machine. Advanced chains a free config behind one working base config so traffic exits through a different route that Google accepts, and exports a chain Xray config user guide.

The app is available as a native desktop build, a local web server on http://localhost:8787, and an Android APK that supports connectivity-only checks. The project describes itself as version 0.1.0, an early pre-release tested end to end only on Windows; other platform builds come from CI and have not been exercised on real devices download and install.

Quick start

1. Get the build for your system from Releases and verify it against SHA256SUMS.txt.
2. On Windows, unzip and run GeminiConfigChecker.exe. WebView2 is built into Windows 10/11. The build is unsigned, so SmartScreen may warn.
3. Launch the app and pick a mode: Simple to check configs you already have, Advanced to chain free configs behind a working base config.
4. Click Sign in with Google; the app opens a separate Chrome/Edge/Brave profile for this purpose and detects when sign-in completes. On Android or without a supported browser, set the check type to connectivity only.
5. Paste configs one per line (vless://, vmess://, trojan://, ss://, a subscription URL, or base64) and press Start scan. The Results tab lists healthy, region-blocked, and errored configs.
6. Use Copy for the share link, or Copy with chain / Copy full config to export an Xray JSON for PattN/PattNG or stock Xray/v2rayN.

For the web server build, run ./gemini-config-checker, optionally with -addr, -no-open, or -version, then open http://localhost:8787 local UI.

Constraints

• Region checking requires Chrome, Edge, Brave, or Chromium; Flatpak browsers cannot be driven. Linux desktop builds need GTK 3 and WebKitGTK 4.1, and the sign-in window needs a graphical session.
• Android cannot drive a signed-in Chromium, so the APK only verifies connectivity, not region availability.
• The default anti-DPI profile applies a fragmentation recipe for filtered networks. It can add latency and should be switched off elsewhere anti-DPI profile.
• Results are samples, not guarantees: a Cloudflare Worker exit can change between connections, so re-test before relying on a config.
• The web UI has no authentication; keep it on localhost or reach it over an SSH tunnel.
• Builds are unsigned; macOS may require right-click Open or xattr -dr com.apple.quarantine. Android APKs signed with different keys cannot update in place.
• Traffic through free configs is operated by unknown third parties; do not send sensitive data through them privacy and security.

HotRepo's take

HotRepo recorded the project on its new-project list on 2026-11-15, reaching 259 stars and 0 forks in a window of less than two hours. That is early attention for a v0.1.0 tool whose only exercised platform is Windows, so the star count reflects novelty rather than demonstrated cross-platform behavior; the Android, macOS, and Linux builds remain untested by the author. The README also has a Dropbox RAR download at the top that differs from the Releases-based distribution described later, which readers should treat cautiously.