• 🚀 One-Command Setup - Enable Gemini features in seconds
• 🛡️ Safe & Reversible - Automatic backups, easy restore
• 🔒 Type-Safe - Built with Rust, uses serde_json for reliable parsing
• 🌍 Cross-Platform - Supports macOS, Linux, and Windows
• 📦 Zero Dependencies - Single binary, no runtime requirements
• 🧪 Well-Tested - 100% test coverage with 22+ tests
• 📝 Clean Logs - Structured logging for debugging
• ⚡ Lightning Fast - Optimized for minimal overhead

# Install (macOS/Linux)
cargo install gemini-unlock

# Run (Chrome must be closed first)
gemini-unlock

# Or automatically close Chrome, patch, and restart
gemini-unlock --kill-chrome

That's it! Restart Chrome and enjoy Gemini features. 🎉

Download the latest release for your platform from Releases:

# macOS (Apple Silicon)
curl -LO https://github.com/flyingzl/gemini-unlock/releases/latest/download/gemini-unlock-aarch64-apple-darwin.tar.gz
tar -xzf gemini-unlock-aarch64-apple-darwin.tar.gz
mv gemini-unlock /usr/local/bin/

# macOS (Intel)
curl -LO https://github.com/flyingzl/gemini-unlock/releases/latest/download/gemini-unlock-x86_64-apple-darwin.tar.gz
tar -xzf gemini-unlock-x86_64-apple-darwin.tar.gz
mv gemini-unlock /usr/local/bin/

# Linux
curl -LO https://github.com/flyingzl/gemini-unlock/releases/latest/download/gemini-unlock-x86_64-unknown-linux-gnu.tar.gz
tar -xzf gemini-unlock-x86_64-unknown-linux-gnu.tar.gz
mv gemini-unlock /usr/local/bin/

# Windows
# Download .exe from Releases page

cargo install gemini-unlock

git clone https://github.com/flyingzl/gemini-unlock.git
cd gemini-unlock
cargo install --path .

# Apply patches (Chrome must be closed)
gemini-unlock

# Automatically close Chrome before patching
gemini-unlock -k

# Restore from backup
gemini-unlock -r

# Show help
gemini-unlock --help

# Enable debug logging
RUST_LOG=debug gemini-unlock

Before using this tool, make sure to configure the following:

Set Google Chrome's language to English:

1. Open Chrome settings
2. Go to Languages section
3. Set Display Google Chrome in this language to English
4. Relaunch Chrome

Configure your VPN/proxy tool to use United States region:

• Set your proxy location to US servers
• Ensure the proxy is active before using Gemini features
• Some features may require a US IP address to function properly

Why these requirements? While this tool modifies Chrome's configuration to indicate US region, Google's servers may perform additional checks. Using US language settings and a US proxy helps ensure maximum compatibility with Gemini features.

This tool modifies Chrome's Local State configuration file to enable Gemini features by:

1. Detecting your operating system and Chrome config location
2. Backing up your original Local State file (as Local State.bak)
3. Patching specific configuration fields:
   • is_glic_eligible: false → true
   • variations_country: <current> → "us"
   • variations_permanent_consistency_country: <current> → ["us"]
4. Validating the modified JSON to ensure Chrome can read it
5. Logging all operations for debugging

Chrome checks these configuration fields to determine Gemini availability. By setting them to US region values, Gemini features become unlocked even if you're in a different region.

Important Notes:

• This only modifies local configuration
• No network requests are made
• No data is sent to external servers
• Changes are reversible via the --restore flag

• Rust 1.85.0 or later (with Rust 2024 edition support)
• Cargo

# Debug build
cargo build

# Release build (optimized)
cargo build --release

# Run tests
cargo test

# Run with logging
RUST_LOG=debug cargo run -- --help

The release binary will be at target/release/gemini-unlock.

We maintain 100% test coverage with 22+ tests:

# Run all tests
cargo test

# Run tests with output
cargo test -- --nocapture

# Run specific test
cargo test test_complete_patch_workflow

# Show test coverage (requires tarpaulin)
cargo tarpaulin --out Html

Test suites include:

• Unit Tests: 13 tests for core functionality
• Integration Tests: 8 tests for end-to-end workflows
• Documentation Tests: 1 test for code examples

The tool operates on Chrome's Local State file:

A backup is created as Local State.bak in the same directory.

This tool is designed with safety in mind:

• ✅ Type-Safe JSON Parsing
  • Uses serde_json, not regex
• ✅ Input Validation
  • Verifies JSON before and after modification
• ✅ Automatic Backups
  • Creates .bak file before changes
• ✅ Process Detection
  • Refuses to run if Chrome is open
• ✅ Zero Network
  • No external connections
• ✅ Open Source
  • Fully auditable code
• ✅ Reversible
  • Easy restore with --restore flag

This project was inspired by and built upon ideas from:

• Gemini-in-Chrome by appsail
  • Original concept and implementation

Special thanks to the original author for the pioneering work on enabling Chrome Gemini features. This Rust implementation aims to provide a safer, cross-platform, and more maintainable solution with comprehensive testing and type-safe JSON handling.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

# Clone your fork
git clone https://github.com/flyingzl/gemini-unlock.git
cd gemini-unlock

# Install development dependencies
cargo install cargo-tarpaulin  # For coverage reports

# Run linter
cargo clippy -- -D warnings

# Format code
cargo fmt

# Run tests
cargo test

This project is licensed under either of:

• MIT License (LICENSE-MIT or https://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)

at your option.

• Built with Rust
• Uses serde and serde_json
• CLI powered by clap
• Error handling with thiserror and anyhow

• Gemini-in-Chrome by appsail - Original implementation
• ungoogled-chromium - Chromium without Google integration
• chromium - Chromium source code

• 🐛 Report Bugs
• 💡 Request Features
• ❓ Ask Questions