screenie

Capture viewport screenshots across 57 device viewports with one command.

Quick Start

``bash
npx screenie-tool https://your-site.com
`

Screenshots are saved to ./screenshots/ and an HTML report opens automatically.

Why screenie?

Manually checking your site on dozens of devices is tedious. screenie captures screenshots across phones, tablets, and desktops in seconds, generating a visual report you can scan at a glance.

Instead of:
- Manually resizing your browser window
- Using browser DevTools to test each device
- Missing edge cases on specific screen sizes
- Spending hours on visual QA

With screenie:
- One command captures all 57 device viewports
- Visual HTML report shows all screenshots in a grid
- Filter by device type (phones, tablets, desktops)
- Complete in seconds with parallel capture

Features

- 57 Device Viewports - Phones, tablets, and desktops from iPhone to 4K displays
- HTML Report - Visual grid of all captures, opens automatically
- Device Presets - --phones-only, --tablets-only, --desktops-only
- Viewport Capture - Fast, focused screenshots of the visible viewport
- Full-Page Option - Use --full-page flag for entire page capture
- Parallel Capture - Configurable concurrency for fast captures
- Zero Config - Works out of the box, no setup required

Installation

$3

No installation needed. Just run:

`bash
npx screenie-tool https://your-site.com
`

This downloads and runs screenie in one step.

$3

For frequent use, install globally:

`bash
npm install -g screenie-tool
`

Then run anywhere:

`bash
screenie https://your-site.com
`

$3

- Node.js 20 or higher
- Chromium is installed automatically on first run via Playwright

Usage

$3

Capture all 57 device viewports:

`bash
screenie https://example.com
`

$3

Capture entire page height (not just viewport):

`bash
screenie https://example.com --full-page
`

$3

Focus on mobile:

`bash
screenie https://example.com --phones-only
`

Focus on tablets:

`bash
screenie https://example.com --tablets-only
`

Focus on desktops:

`bash
screenie https://example.com --desktops-only
`

$3

Capture several pages in one run:

`bash
screenie https://example.com --pages / /about /pricing /contact
`

$3

Save screenshots to a specific location:

`bash
screenie https://example.com -o ./my-screenshots
`

$3

If your page has animations or lazy-loaded content:

`bash
screenie https://example.com --wait 2000
`

$3

Adjust parallel captures (default is auto-detected):

`bash
screenie https://example.com --concurrency 5
`

$3

Generate screenshots without opening the browser:

`bash
screenie https://example.com --no-open
`

Options

| Option | Description | Default |
|--------|-------------|---------|
| --phones-only | Only capture phone devices (24 devices) | all |
| --tablets-only | Only capture tablet devices (13 devices) | all |
| --desktops-only | Only capture desktop devices (20 devices) | all |
| --full-page | Capture entire page instead of viewport | viewport-only |
| -c, --concurrency | Parallel captures (1-50) | auto |
| -w, --wait | Wait after page load | 0 |
| -o, --output