


SiteShoter v1.06
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.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 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.

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
