GitPedia

Screenshoteer

Make website screenshots and mobile emulations from the command line.

From vladocar·Updated June 7, 2026·View on GitHub·

Makes web screenshots and mobile emulations from the command line. The project is written primarily in JavaScript, distributed under the MIT License license, first published in 2018. It has gained significant community traction with 1,666 stars and 86 forks on GitHub. Key topics include: emulates, mobile, mobile-emulations, nodejs, npm-scripts.

<h1 align="center"> Screenshoteer </h1> <p align="center"> Makes web screenshots and mobile emulations from the command line. </p> <p align="center"><img src="carbon-shot.png" /></p> <hr/> <p>Tool based on <a href="https://github.com/GoogleChrome/puppeteer">puppeteer</a>. </p> <h4>Installation </h4>
shell
npm i -g screenshoteer
<p>You can use screenshoteer like this:</p>
shell
screenshoteer --url https://www.example.com or .html localy copy the url path from the browser screenshoteer --url file:///Users/../index.html screenshoteer --url file:///C:/Users/../Random-HTML-file.html
<p>And with the help of puppeteer(Headless Chrome) it will generate screenshot of the entire web page.</p> <p> Parameters:

-h help
--url web page url
--emulate - emulate web device example: --emulate "iPhone 6"
--fullpage - can be true or false. It will take screenshot of entire web page if is true. True is the default parameter.
--pdf - generate additional pdf
--w - width of the Web Page in px
--h - height of the Web Page in px
--waitfor - wait time for the page load in milliseconds
--waitforselector - wait for the selector to appear in page
--el - css selector document.querySelector
--auth - basic http authentication
--no - exclude "image", "stylesheet", "script", "font"
--click - example: ".selector>a" excellent way to close popups or to click some buttons on the page.
--file - output file name (optional, otherwise based on page title and timestamp)
--theme - switch to dark or light color theme
--vd - Emulate vision deficiency 'achromatopsia', 'deuteranopia', 'protanopia', 'tritanopia', 'blurredVision', and 'none'

<p> <h4>Example: </h4>
shell
screenshoteer --url https://news.ycombinator.com --fullpage false screenshoteer --url https://www.reddit.com/r/nodejs --emulate "iPhone 7" screenshoteer --url https://www.nytimes.com --emulate "Nexus 4" screenshoteer --url https://www.reddit.com/r/javascript/ --w 600 --h 800 --fullpage false screenshoteer --url https://www.reddit.com/r/javascript/ --w 600 --h 0 --fullpage false screenshoteer --url https://lobste.rs --pdf screenshoteer --url https://lobste.rs --w 500 screenshoteer --url https://news.ycombinator.com/item?id=18598672 --el ".fatitem" screenshoteer --url https://site.com --auth "username;password" screenshoteer --url https://www.nytimes.com --no "image" screenshoteer --url https://www.nytimes.com --no "script" screenshoteer --url https://www.economist.com/ --click ".ribbon__close-button" screenshoteer --url file:///Users/../index.html screenshoteer --url https://www.slashdot.org --file /tmp/slashdot.png screenshoteer --url https://mxb.dev/blog/color-theme-switcher/ --theme dark screenshoteer --url https://news.ycombinator.com --vd blurredVision
<p> List of of supported mobile devices: https://github.com/GoogleChrome/puppeteer/blob/master/DeviceDescriptors.js </p> <h3>License</h3>

This project is licensed under the MIT License

Contributors

Showing top 12 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from vladocar/screenshoteer via the GitHub API.Last fetched: 6/20/2026