browshot-cmd.exe: take screenshots from Windows

We have released a tool on Windows to take screenshots from the command line or to schedule screenshot automatically with browshot-cmd.exe


Download the archive Unzip all the file in any directory.
Make sure Browhsot.dll and browshot-cmd.exe are in the same folder.

browshot-cmd.exe from the command line

Open the command line on Windows (Command Prompt or cmd.exe). Go into the directory that contains browshot-cmd.exe. Run browshot-cmd.exe --help to get the full list of options:

C:\Users\Julien\Downloads\browshot-cmd>browshot-cmd.exe --help
Usage: browshot.exe: OPTIONS
Interact with the Browshot API.

  -u, --url=URL              the URL for the screenshot
  -k, --key=KEY              your API KEY
                               default =
  -f, --file=FILENAME        FILENAME to use for the screenshot images
                               default =
  -i, --instance=INSTANCE_ID INSTANCE_ID to use
                               default = 65
  -z, --size=SIZE            the screenshot SIZE, 'page' or 'screen'
                               default = screen
  -d, --delay=SECONDS        number of SECONDS to wait after the page is
                               default = 5
      --fd, --flash_delay=SECONDS
                             number of SECONDS to wait if Flash objects are
                               default = 5
  -o, --format=FORMAT        the image FORMAT of the screenshot, 'png' or
                               default = png
  -q, --quality=QUALITY      JPEG image QUALITY of the screenshot
                               Optional, default = 90
  -s, --shots=SHOTS          the number of SHOTS of the same page
                               Optional, default = 1
      --si, --shot_interval=SECONDS
                             the number of SECONDS between 2 screenshots of
                               the same page
                               Optional, default = 5
  -c, --cache=SECONDS        get a previous screenshots if done within
                               default = 8600
  -w, --width=WIDTH          thumbnail WIDTH
                               default = 0
  -e, --height=HEIGHT        thumbnail HEIGHT
                               default = 0
      --sw, --screen_width=WIDTH
                             browser screen WIDTH
                               default = 0
      --sh, --screen_height=HEIGHT
                             browser screen HEIGHT
                               default = 0
      --referrer=REFERRER    REFERRER Url
                               default =
      --script=JAVASCRIPT    JAVASCRIPT Url to inject in the page
                               default =
      --post_data=POST DATA  POST DATA for a POST request
                               default =
  -h, --help, -?             show the list of options

The options match the different options to create screenshots through the Browshot API.

To take a screenshot of on the premium instance 58, use this command:

C:\Users\Julien\Downloads\browshot-cmd>browshot-cmd.exe --url= --instance=58 --size=page --screen_width=1280 --screen_height=1024 --width=640 --key=my_api_key
Screenshot for - attempt: 1
ID: 42250735
Status: in_queue
Waiting 20 seconds...
Screenshot ID: 42250735
Screenshot saved to 42250735.png

browshot-cmd.exe.config: default values

Instead of specifying the same arguments every time you take a screenshot (key, instance ID, screen_width, etc.), you can save your default parameter in the file browshot-cmd.exe.config.

After you update browshot-cmd.exe.config, browshot-cmd.exe --help will display the default values saved in the file.

Schedule screenshots

You can use browshot-cmd.exe with the Windows task scheduler to take screenshots automatically.

browshot-schedule.xml is an example of a task. You need to edit it and change the folder and argument at the end of the file. Then, open Windows Task Scheduler and import browshot-schedule.xml. You can change additional settings such as the frequency and the start time of the task.

Try it for free


sign up for free account

Already have an account?

no credit card required

About Us

Browshot is a web service to create real time web screenshots in a multitude of virtual devices, including mobile devices like the iPhone 3 & 4, iPad, Android Nexus, etc.

You can use the web dashboard, or our full-featured API.

  • Real time screenshots

  • 15+ mobile devices: iPhone, iPad, Android, etc.

  • 30+ desktop resolutions

  • Fast and reliable

  • Thumbnails of any size, any ratio

  • Full API, open-source libraries