Autogun is a configuration language and toolchain to automate headless browsers. Currently, it uses the Chrome DevTools protocol to automate Chromium-based browsers.
[!important] Autogun is pre-alpha software. Features are subject to change, and compatibility may vary until Autogun reaches 1.0.
To get started with Autogun, install the executable using Go:
go install github.com/Carbonfrost/autogun/cmd/autogun@latestthen use autogun from your scripts. For example, to navigate to a webpage and obtain its title:
autogun run https://github.com/Carbonfrost/autogun -titleCheck out our docs for more guidance on how to use Autogun.
-
Capture a screenshot of a website, emulating iPhone 7 in landscape orientation
autogun run --device=iPhone7landscape https://www.whatsmyua.info -screenshot file=iphone7-landscape-screenshot.png
- Download and install Go 1.25+
- Run
go build ./... - Run the tests using
go test ./...
This project has adopted a Code of conduct.
This project uses a BSD-style license.