Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
June 2, 2022 15:05
February 27, 2023 13:26
March 6, 2017 17:24
March 30, 2018 13:23


This tool downloads, installs, and configures a shiny new copy of Chromium.

It includes nifty things like:

  • Turning off all those annoying auto-updaters!
  • Sweet colored themes for high visibility!
  • No XSS auditor!
  • Automatic proxy configuration! (uses
  • An annoying infobar because it doesn't check TLS certs!
  • Basic integration with Burp if you install the included Burp extension

Currently, the following OSes are supported:

  • macOS 10.9 (Mavericks) and higher
  • Ubuntu 16.04 (and other XDG-supporting Linuxes)

You will need ruby version 2.0 or higher and unzip. These are included in supported macOS versions. You may need to apt install ruby on Linux.


  1. ruby autochrome.rb
  2. Launch Chromium.
    • MacOS: open ~/Applications/
    • Linux: ~/.local/autochrome/chrome
  3. Open the "Getting Started" bookmark.


Execute the following command: ruby autochrome.rb

If you've already installed Chromium with this tool before, run ruby autochrome.rb -c to delete the old installation and install a new one.

If you just want to recreate the profiles without redownloading Chrome, run ruby autochrome.rb -P.

Use the -h flag to see all of the options.

The "versions" used with this tool are Chromium revisions. You can get a list of the last known good versions here (use the six-digit number after refs/heads/master), and you can find out what revision a given build of Chrome uses here.


Once you've installed Chromium, it will be placed in the ~/Applications/ directory on OS X or the ~/.local/autochrome/ directory on Linux.

The command open ~/Applications/ is one way to launch it on OS X. ~/.local/autochrome/chrome is a way to launch it on Linux.

Once you've launched Chromium, open the "Getting Started" bookmark.

Chrome extensions

Autochrome comes with several small utility extensions; you can add more in the data/extensions directory.

The build_extensions.rb script will rebuild all extensions under data/extension_source, and the standard set of colored themes. This script uses the version of chromium installed by autochrome from the default directory. You must have completed the installation first.

Settings Resetter

Makes it easy to wipe cookies or all browser history from the menu bar.

Autochrome Integration

Adds a tag to the outgoing user agent to let Burp identify it. Menu bar icon does nothing.

Copyright and License

Autochrome is copyright 2017, NCC Group, and licensed under the Apache license (see LICENSE.txt).