Proxy for using W3C WebDriver-compatible clients to interact with Gecko-based browsers.
This program provides the HTTP API described by the WebDriver protocol to communicate with Gecko browsers, such as Firefox. It translates calls into the Marionette automation protocol by acting as a proxy between the local- and remote ends.
You can consult the change log for a record of all notable changes to the program.
Marionette and geckodriver are not yet feature complete. This means it does not yet offer full conformance with the WebDriver standard or complete compatibility with Selenium.
You can track the implementation status of the latest Firefox Nightly on MDN. We also keep track known Marionette, Selenium, and specification problems in our issue tracker.
Marionette support is best in Firefox 48 and onwards, although the more recent the Firefox version, the more bug fixes and features. Firefox 47 is explicitly not supported.
geckodriver is written in Rust and you need the Rust toolchain to compile it.
To build the project for release, ensure you do a compilation with optimisations:
% cargo build --release
Or if you want a non-optimised binary for debugging:
% cargo build
Usage steps are documented on MDN, but the gist of it is this:
% geckodriver -b /usr/bin/firefox
Or if you’re on Mac:
% geckodriver -b /Applications/FirefoxNightly.app/Contents/MacOS/firefox-bin