✨ Features

• 🚀 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

🎯 Quick Start

# 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. 🎉

📦 Installation

Binary Release (Recommended)

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

cargo install gemini-unlock

From Source

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

💻 Usage

Basic Usage

# 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

Command-Line Options

Environment Variables

🔧 How it Works

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

Why This Works

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

🏗️ Building from Source

Prerequisites

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

Build Commands

# 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.

🧪 Testing

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

📁 File Locations

The tool operates on Chrome's Local State file:

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

🛡️ Safety

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

💡 Inspiration

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.

🤝 Contributing

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

Development Setup

# 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

📄 License

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.

🙏 Acknowledgments

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

📚 Related Projects

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

📞 Support

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