pageres-cli



Capture screenshots of websites in various resolutions. A good way to make sure your websites are responsive. It's speedy and generates 100 screenshots from 10 different websites in just over a minute. It can also be used to render SVG images.

See pageres for the programmatic API and issues tracker.

Install

``sh
npm install --global pageres-cli
`

Note to Linux users: If you get a "No usable sandbox!" error, you need to enable system sandboxing.

Usage

Specify urls and screen resolutions as arguments. Order doesn't matter.

If no resolution is specified it will default to 1366x768 which is the most popular resolution.

Note: Device keywords (like iphone5s, ipad, etc.) are no longer supported. Use explicit resolutions instead.

`sh
pageres
pageres

can also be a local file path.


pageres
`

List multiple urls and resolutions for pageres to capture all combinations.

`sh
pageres ...

pageres https://sindresorhus.com 1024x768 1366x768 # 2 screenshots
pageres https://sindresorhus.com https://example.com 1024x768 # 2 screenshots
pageres https://sindresorhus.com https://example.com 1024x768 1366x768 # 4 screenshots
`

Group arguments with square brackets.

`sh
pageres [ ] [ ]
pageres [ ... ]

Mix grouped and single arguments

pageres [ https://example.com 1024x768 1600x900 ] https://sindresorhus.com 1366x768

Options defined inside a group will override the outer ones.

pageres [ https://example.com 1024x768 --no-crop ] https://sindresorhus.com 1366x768 --crop
`

Screenshots are saved in the current directory.

$3

`sh


Basic multi-url, multi-resolution usage

pageres https://sindresorhus.com https://example.com 1366x768 1600x900

Override outer option within group

pageres [ https://example.com 1366x768 1600x900 --no-crop ] [ https://sindresorhus.com 1024x768 480x320 ] --crop

Provide a custom filename template

pageres https://sindresorhus.com 1024x768 --filename='<%= date %> - <%= url %>'

Capture a specific element

pageres https://example.com 1366x768 --selector='.page-header'

Hide a specific element

pageres https://example.com 1366x768 --hide='.page-header'

Capture a local file

pageres unicorn.html 1366x768
`

$3

##### --verbose, -v

Verbose output to see errors if you need to troubleshoot.

##### --crop, -c

Crop to the set height.

`sh
pageres https://sindresorhus.com 1024x768 --crop
`

##### --delay=, -d

Delay screenshot capture.

`sh
pageres https://sindresorhus.com 1024x768 --delay=3
`

##### --filename=