1.8

• shot-scraper javascript can now optionally load scripts hosted on GitHub via the new gh: prefix to the shot-scraper javascript -i/--input option. #173

  Scripts can be referenced as gh:username/repo/path/to/script.js or, if the GitHub user has created a dedicated shot-scraper-scripts repository and placed scripts in the root of it, using gh:username/name-of-script.

  For example, to run this readability.js script against any web page you can use the following:

  shot-scraper javascript -i gh:simonw/readability \
    https://simonwillison.net/2025/Mar/24/qwen25-vl-32b/

1.7

• New options for the shot-scraper har command: --wait, --wait-for and --javascript - similar to those same options on shot-scraper shot. #171
• Documentation now recommends using shot-scraper multi --har-zip for larger collections of files to avoid a Playwright crash if the .har JSON grows too large. #170

1.6

• New shot-scraper har URL command for creating an HTML Archive of a page. #146
• shot-scraper multi --har and --har-zip and --har-file options for creating an HTML Archive of multiple pages. #166
• shot-scraper pdf now has --wait-for and --timeout options. Thanks, miccou. #161

1.5

• Several new features for the YAML configuration used by shot-scraper multi:
  • You can now add a - server: python -m http.server 8003 block to start a server running before screenshots are taken. The PID for this server will be recorded and the server automatically terminated when the command completes, unless you specify the --leave-server option in which case it will be left running, useful for debugging. #156
  • The sh: shell command or python: python code blocks can specify Python or shell commands to run before a screenshot is taken. This means a YAML script can make modifications to the environment in between screenshots, useful for things like progressive tutorials. #155
• Fixed a bug that occurred if a max-width was accidentally applied to the <div> used for region screenshots. Thanks, Johann Klähn. #143
• Documented that shot-scraper will quit with an error if a --wait-for expression has not resolved in 30s.

1.4

• New --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
• New --scale-factor option for setting scale factors other than 2 (for retina). Thanks, Niel Thiart. #136
• New --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

1.3

• New --bypass-csp option for bypassing any Content Security Policy on the page that prevents executing further JavaScript. Thanks, Brenton Cleeland. #116
• Screenshots taken using 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
• Improved accessibility of documentation. Thanks, Paolo Melchiorre. #120

1.2

• New --omit-background option to the shot command to optionally create transparent PNGs. Thanks, Ben Welsh. #108
• Fixed bug that caused shot-scraper to fail to take screenshots on Windows. Thanks, Omer Rosenbaum. #104
• New --silent option for the shot, multi, pdf and html commands, to disable the default console output. #107

Full documentation: https://shot-scraper.datasette.io/

1.1.1

• Deprecated the 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

1.1

• New --log-console option for logging the output of calls to console.log() to standard error. #101
• New --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

1.0.1

• shot-scraper.datasette.io homepage now includes an example screenshot. #97