chromedriver-binary

A Ruby gem that automatically downloads and installs ChromeDriver binaries that match your installed Chrome browser version.

Inspired by webdrivers

• Automatically detects Chrome browser version
• Downloads the matching ChromeDriver version
• Works across Windows, macOS, and Linux platforms
• Supports environment variable configuration
• Minimal dependencies

Add this to your application's Gemfile:

gem 'chromedriver-binary'

And then execute:

$ bundle install

Or install it yourself:

$ gem install chromedriver-binary

Simply require the gem in your code:

require 'chromedriver/binary'

Chromedriver::Binary.configure do |config|
  # default STDOUT logger
  config.logger = logger

  # Proxy default nil
  config.proxy_addr = 'myproxy_address.com'
  config.proxy_port = '8080'
  config.proxy_user = 'username'
  config.proxy_pass = 'password'

  # install dir
  config.install_dir = "/tmp" # default "~/.webdrivers"
end

Chromedriver::Binary::ChromedriverDownloader.update force: true

Chromedriver::Binary::ChromedriverDownloader.driver_path

require "chromedriver/binary"

load 'chromedriver/Rakefile'

The gem will:

1. Detect your installed Chrome version
2. Download the matching ChromeDriver binary if needed
3. Make it available in your PATH

Use environment variables to customize behavior:

• CHROMEDRIVER_CHROME_PATH: Specify the Chrome binary location
• CHROMEDRIVER_BINARY_PATH: Override where ChromeDriver is installed

After checking out the repo:

$ bin/setup               # Install dependencies
$ rake spec               # Run the tests
$ bundle exec rake install # Install the gem locally

The gem is available as open source under the terms of the MIT License.