


SiteShoter v1.20
Copyright (c) 2008 Nir Sofer
Web site: http://www.nirsoft.net



Description
===========

SiteShoter is a small utility that allows you to save a screenshot of any
Web page into a file. It automatically creates hidden window of Internet
Explorer, loads the desired Web page, and than save the entire content of
the Web page into an image file (.png, .jpg, .tiff, .bmp or .gif).
You can use SiteShoter in user interface mode, or alternatively, you can
run SiteShoter in command-line mode without displaying any user interface.



System Requirements
===================

This utility works on Windows XP, Window 2003 Server, and Windows Vista.
You can also use this utility in Windows 2000, if GDI+ is installed.



Versions History
================


* Version 1.20
  o Added new option: 'Take a screenshot of this Web page every...'

* Version 1.18
  o Fixed bug with dialog-box resizing.
  o Added %host% variable.

* Version 1.17
  o The main dialog-box is now resizable.

* Version 1.16
  o When cut width/height are negative numbers, the cut width/height
    values will be subtract from the total width/height of the page. This
    feature can be useful if you want to cut a footer of a Web page. For
    example, if the number of pixels in footer of the Web page is 100,
    put -100 in the Cut Height field.

* Version 1.15
  o Added support for handling a sequence of URLs, saved in a text
    file. (The URLs should be delimited by CRLF)

* Version 1.10
  o Added support for automatically saving the URL in filename (%url%)
  o Added AutoComplete for filename field.

* Version 1.09
  o Added support for current date/time Formatting in the save
    filename.

* Version 1.08
  o Added new option: Cut Web page in the specified location.

* Version 1.07
  o Added AutoComplete support for the URL text-box.
  o Fixed bug: Accelerator keys didn't work...

* Version 1.06
  o Fixed a GDI resources leak.

* Version 1.05
  o New option: Automatically extend browser size according to Web
    page

* Version 1.00 - First release.



Known Problems
==============


* Currently, SiteShoter cannot capture the content of Java applets, and
  possibly some other 3-party components.



Using SiteShoter
================

SiteShoter doesn't require any installation process or additional DLL
files. In order to start using it, simply run the executable file
(SiteShoter.exe)
After you run it, type the URL of the Web page that you want to capture,
and select the image filename that you want to save. You can also modify
the other options, like browser width/height, disable Flash, and so on.
Click the 'Start' button and wait a few seconds until the Web site is
loaded and saved into a file. (The default timeout value is 10 seconds,
you may change it according to your needs)



Automatically extend browser size according to Web page
=======================================================

Starting from version 1.05, SiteShoter allows you to extend the Web
browser size according to the size of the Web page, so the entire Web
page will be captured. However, be aware that this feature won't work on
Web pages with multiple frames.
Also, when this feature is turned on, you can limit the maximum allowed
browser size by using the 'Maximum Width' and 'Maximum Height' fields.



Using The URL In The Saved Filename
===================================

If you want to use the URL of the Web site as the saved filename, simply
use the %url% variable in the filename field. You can also use the %host%
variable to get only the host name, without the other parts of the URL.
For example: c:\temp\%url%.png



Formatting Save Filename With Current Date/Time
===============================================

Starting from version 1.09, you can use the following special SiteShoter
variables for formatting the filename according to the current date or
time:
* %time:[format]%
* %date:[format]%

The time format string may contain the following elements: (The format
string is case sensitive !)

h
Hours with no leading zero for single-digit hours; 12-hour clock.

hh
Hours with leading zero for single-digit hours; 12-hour clock.

H
Hours with no leading zero for single-digit hours; 24-hour clock.

HH
Hours with leading zero for single-digit hours; 24-hour clock.

m
Minutes with no leading zero for single-digit minutes.

mm
Minutes with leading zero for single-digit minutes.

s
Seconds with no leading zero for single-digit seconds.

ss
Seconds with leading zero for single-digit seconds.

t
One character time-marker string, such as A or P.

tt
Multicharacter time-marker string, such as AM or PM.

The date format string may contain the following elements: (The format
string is case sensitive !)

d
Day of month as digits with no leading zero for single-digit days.

dd
Day of month as digits with leading zero for single-digit days.

ddd
Day of week as a three-letter abbreviation.

dddd
Day of week as its full name.

M
Month as digits with no leading zero for single-digit months.

MM
Month as digits with leading zero for single-digit months.

MMM
Month as a three-letter abbreviation.

MMMM
Month as its full name.

y
Year as last two digits, but with no leading zero for years less than 10.

yy
Year as last two digits, but with leading zero for years less than 10.

yyyy
Year represented by full four digits.

Here's some examples for filename strings with date/time format:
c:\temp\%date:MMddyyyy%\g%time:HHmmss%.png
c:\temp\mysite%time:HHmm%.jpg
c:\temp\site%date:MMyyyy%\nirsoft.png

Be aware that if a folder formated with date/time doesn't exist,
SiteShoter will automatically create it for you.



Using SiteShoter From Command-Line
==================================

In order to take a screenshot of a Web page from command-line, you can
use one or more from the following command-line parameters. Any parameter
that you don't specify in the command-line is automatically loaded from
the configuration file of SiteShoter (SiteShoter.cfg).

/URL <http://...>
Specifies the address of the Web page.

/Filename <Filename>
Specifies the filename that you want to save

/BrowserWidth <Width in pixels>
Specifies the width of browser window, in pixels.

/BrowserHeight <Height in pixels>
Specifies the height of browser window, in pixels.

/BrowserAutoSize <0 | 1>
Automatically extend the Web browser size according to the size of the
Web page. Specify 1 to enable this feature, 0 to disable

/MaxBrowserWidth <Width in pixels>
Specifies the maximum allowed width of browser window, in pixels. Only
relevant when BrowserAutoSize is enabled.

/MaxBrowserHeight <Height in pixels>
Specifies the maximum allowed height of browser window, in pixels. Only
relevant when BrowserAutoSize is enabled.

/BrowserTimeout <Timeout in milliseconds>
Specifies the number of milliseconds to wait for the Web page to load.

/JpegQuality <Jpeg Quality [0 - 100]>
Specifies the quality of Jpeg file. 100 - the best quality. On relevant
when you save into a .jpg file.

/ImageSizePerCent <Image size in %>
Specifies the size of the saved image, in percent of the browser window.
For example: if you specify that the browser window is 640x480, and the
image percent value is 50%, the saved image will be 320x240

/DisableScrollBars <0 | 1>
Specifies whether you want to disable the scrollbars of the main browser
window. Specify 1 to disable or 0 to enable.

/DisableJavaScript <0 | 1>
Specifies whether you want to disable the JavaScript component of the Web
browser.

/DisableFlash <0 | 1>
Specifies whether you want to disable the Flash components appears on the
Web page.

/OpenImageAfterSave <0 | 1>
Specifies if you want to open the saved image file with the default image
viewer.

/CutWebPage <0 | 1>
Specifies if you want to cut the Web page in the location specified in
CutLeft, CutTop, CutWidth, and CutHeight parameters.

/CutLeft <Left in pixels>
/CutTop <Top in pixels>
/CutWidth <Width in pixels>
/CutHeight <Height in pixels>

Specifies the location the you want to cut the Web page. (Only when
CutWebPage = 1)

/URLMode <1 | 2>
Specifies the URL mode.
1 = Single URL, the URL is taken from /URL parameter. 2 = Multiple URLs.
The URL list is taken from a text file specified in /URLsFilename

/URLsFilename <URL Text Filename>
/URLsFilename
Specifies the URL filename when URLMode = 2.

Here's some examples:
SiteShoter.exe /URL http://www.nirsoft.net /Filename
"c:\temp\nirsoft.png" /DisableScrollBars 1 /BrowserWidth 800
/BrowserHeight 2000 /ImageSizePerCent 50
SiteShoter.exe /URL http://www.microsoft.com/ /Filename
"c:\temp\microsoft.png" /DisableScrollBars 1 /BrowserWidth 1024
/BrowserHeight 1500 /ImageSizePerCent 100 /DisableJavaScript 1
SiteShoter.exe /URL http://www.accuweather.com/ /Filename
"c:\temp\weather.tiff" /DisableScrollBars 1 /BrowserWidth 1024
/BrowserHeight 2000 /ImageSizePerCent 100 /DisableFlash 1
SiteShoter.exe /URL http://www.yahoo.com /Filename "f:\temp\yahoo.jpg"
/DisableScrollBars 1 /BrowserWidth 1024 /BrowserHeight 768
/ImageSizePerCent 100 /JpegQuality 50
SiteShoter.exe /URL http://www.cnet.com /Filename "c:\temp\cnet.png"
/DisableScrollBars 1 /BrowserAutoSize 1



Translating SiteShoter to other languages
=========================================

In order to translate SiteShoter to other language, follow the
instructions below:
1. Run SiteShoter with /savelangfile parameter:
   SiteShoter.exe /savelangfile
   A file named SiteShoter_lng.ini will be created in the folder of
   SiteShoter utility.
2. Open the created language file in Notepad or in any other text
   editor.
3. Translate all string entries to the desired language. Optionally,
   you can also add your name and/or a link to your Web site.
   (TranslatorName and TranslatorURL values) If you add this information,
   it'll be used in the 'About' window.
4. After you finish the translation, Run SiteShoter, and all
   translated strings will be loaded from the language file.
   If you want to run SiteShoter without the translation, simply rename
   the language file, or move it to another folder.



License
=======

This utility is released as freeware. You are allowed to freely
distribute this utility via floppy disk, CD-ROM, Internet, or in any
other way, as long as you don't charge anything for this. If you
distribute this utility, you must include all files in the distribution
package, without any modification !



Disclaimer
==========

The software is provided "AS IS" without any warranty, either expressed
or implied, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. The author will not
be liable for any special, incidental, consequential or indirect damages
due to loss of data or any other reason.



Feedback
========

If you have any problem, suggestion, comment, or you found a bug in my
utility, you can send a message to nirsofer@yahoo.com
