Skip to content


Subversion checkout URL

You can clone with
Download ZIP
JavaScript HTML
Branch: master
Failed to load latest commit information.
tasks improvements
test indentation
.editorconfig improvements
.gitignore Add tests, refacgtor a little
.jshintrc initial commit
.npmignore improvements
.travis.yml test on newer node
Gruntfile.js tests Add tests, refacgtor a little
license Create license
package.json 1.0.0

grunt-localscreenshots Build Status

This is my modification of original grunt-autoshot plugin. (

Getting Started

This plugin requires Grunt.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins.

With this plugin you can make screenshots of all static html files located inside of some directory.

Create a quick screenshot for your site which could help for document or testing. Inspired by Testing your responsive design with PhantomJS, also suport different resolution base on your viewport, it's useful to responsive design.

It will start a static web server and from options path directory and pass all the html files as ursl to it, and create teh screenshots from it.

npm install grunt-localscreenshots --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


Final and the most important thing, please make sure phantomjs are in your PATH, cause this plugin use it to generate screenshot, so remember install first.

The "localscreenshots" task


In your project's Gruntfile, add a section named localscreenshots to the data object passed into grunt.initConfig().

        localscreenshots: {
                options: {
                    path: 'screenshots',
                    type: 'png',
                    local : {
                        path: 'public',
                        port: 3000
                    viewport: ['600x800', '768x1024', '1024x1024'],
                src: ['public/*.html']



Type: String

Path to the directory which screenshots will be saved.


Type: String

Image type of screenshot. PhantomJS supports JPEG, PNG, GIF and PDF right now.


Type: String

Start a local http server to host your webpage then get the screenshot. There are several config options:

  path: './dist', // path to directory of the webpage
  port: 8080      // port of startup http server


Type: Array

Autoshot could create the screenshot base on given viewport, it's helpful if you want to test responsive webpage.

ex: ['1024x768', '1920x1080']

You could add any resolution you want, just follow the same format.

Something went wrong with that request. Please try again.