A command-line utility for taking automated screenshots of websites
--auth-username x --auth-password y
options for each shot-scraper
command, allowing a username and password to be set for HTTP Basic authentication. #140
shot-scraper URL --interactive
mode now respects the -w
and -h
arguments setting the size of the browser viewport. Thanks, mhalle. #128
--scale-factor
option for setting scale factors other than 2 (for retina). Thanks, Niel Thiart. #136
--browser-arg
option for passing extra browser arguments (such as --browser-args "--font-render-hinting=none"
) through to the underlying browser. Thanks, Niel Thiart. #137
--bypass-csp
option for bypassing any Content Security Policy on the page that prevents executing further JavaScript. Thanks, Brenton Cleeland. #116
shot-scraper --interactive $URL
- which allows you to interact with the page in a browser window and then hit <enter>
to take the screenshot - it no longer reloads the page before taking the shot (which ignored your activity). #125
--omit-background
option to the shot
command to optionally create transparent PNGs. Thanks, Ben Welsh. #108
shot-scraper
to fail to take screenshots on Windows. Thanks, Omer Rosenbaum. #104
--silent
option for the shot
, multi
, pdf
and html
commands, to disable the default console output. #107
Full documentation: https://shot-scraper.datasette.io/
shot-scraper multi --fail-on-error
option in favor of the new --fail
option. --fail-on-error
will continue to work until shot-scraper
2.0 (should that ever be released), but is no longer displayed in the --help
menu or documentation. #103
--log-console
option for logging the output of calls to console.log()
to standard error. #101
--skip
and --fail
options to specify what should happen if an HTTP 4xx or 5xx error is encountered while trying to load the page. --skip
will ignore the error and either exit cleanly or move on to the next screenshot (in the case of multi
). --fail
will cause the tool to return a non-zero exit code, useful for running in CI environments. #102
shot-scraper html URL
command (documented here) for outputting the final HTML of a page, after JavaScript has been executed. #96
shot-scraper javascript
has a new -r/--raw
option for outputting the result of the JavaScript expression as a raw string rather than JSON encoded (shot-scraper javascript documentation). #95
shot-scraper multi -o
option for specifying a subset of one or more output files to execute that are defined in the YAML. This is useful for testing a larger shots.yml
file without re-taking every screenshot every time the command is run. #94
--log-requests
on a page that includes a redirect. #90
--log-requests
output now includes a "status": 200
field indicating the HTTP status code returned by that response.--log-requests
tries to log a request with an unknown response size. #89