WebGrabber
Version 1.1 build 66 (Release version)

A Java application that imports web files into your computer


REQUIREMENT
Installed Java virtual machine (tested on version 1.3.1 and 1.4.1_02) 
Screen resolution of 1024 x 768 or better (1280 x1024 recommended) 
Web navigator that supports internet shortcuts (Internet Explorer 5, and most recent version of major Web browsers); however, with the help of a special dialog, you can create the required shortcuts from older browsers as long as you can copy the URL of your viewed pages and/or hyperlinks 
Windows 95 or better OR Linux versions that support Java 1.3.1 or newer and with Gnome 1.4
Fast Internet connection recommended (usable on a 56Kbaud rate; you have to modify the configuration)
Basic (elementary level) knowledge of HTML


INSTALLATION

Simply unzip the webgrabber.zip file under a sub-directory (or folder) of your choice (it will become the WebGrabber directory).


LAST-MINUTE INFORMATION

 USING THE HELP SERVER
   You can also use webgrabber.jar as a HELP SERVER running on an independant process.
   The help server should be started first from a separate Shell/DOS box set at the WebGrabber directory.
   Type the following command:
     java -cp ./webgrabber.jar webgrabber.tools.Help  [portNo] [hostIP] [-Remote]
    an example (with default values explicitely written)
      java -jar wghelp.jar 2000 localhost
       
    portNo should be above 1024 (valuse below 1024 might have non-predictable/non-supported results)
    hostIP can be a name of an IP address
    -Remote, if present it redirects error messages into a file at the WebGrabber directory: HelpServerLog.txt

   Before starting webgrabber.jar as WebGrabber (the normal use), make sure that the helpConfig.txt file is properly edited (comment the TYPE=JAR line and uncomment the TYPE=SOCKET line)
   You may then start the normal WebGrabber (ex. double-click the webgrabber.jar icon)
   When you stop WebGrabber using the help server, check the the help server has stopped also (the prompt should be back at the shell/DOS box from where you have started the help server). If not, kill the server.
   If next time, you do not plan to use a help server, remember to re-edit helpConfig.txt into its initial content (i.e. comment the TYPE=SOCKET line and uncomment the TYPE=JAR line)
   
 HOST SYSTEM LOOK AND FEEL
   If you hate the Java (a.k.a. Metal) Look and Feel and prefer your operating system Look and Feel, just starts WebGrabber from a Shell/DOS box with one parameter (any value) example: java -jar webgrabber.jar 0

 WEBGRABBER DESKTOP LAYOUT FILES
   The default desktop layout file name is WSGFrame.ser and it should be at the installation directory.
   Two other layout files are included in this package: WSGFrame-1280.ser and WSGFrame-1024.ser. The first is for a 1280 pixels wide screen, the other is for a 1024 pixels wide screen.
   The delivered WSGFrame.ser file has the same content as the WSGFrame-1024.ser file. If your screen is 1280 pixels wide, you may just rename WSGFrame-1280.ser as WSGFrame.ser

 END OF OPERATIONS ALERT
   For Win9x users, a freeware WAV file player has been included. See copyright notice at the nottom of the page,
   The following files are included for providing an audio alert when a Grab or Compound-Import operation has completed: wav.exe, wav.txt and jingle.wav.
   If you plan to use your own sound file and audio player, you are free to do so. You may then remove these files.
   A freeware sound is included in this package (jingle.wav), no MS Windows sound is included in this package because of copyright restrictions.
   If you do not like the alert sound, simply copy your preferred WAV file into the WebGrabber directory and modify the Sound command from the General panel of the Configuration dialog. You may disable the sound alert also.

HISTORY
030412 Version 1.1 build 66 (Release version)
  Add the ability to remove HTML text of imported Web pages that may contain unwanted scripts and provoke undesired Internet communication. For this purpose, search expressions (a highly simplified version of regular expressions) are defined by the user. 
  Add supportive functions for enforcing compliance or reporting non-compliance of file names to Joliet specifications. Useful if you plan to archive the imported Web pages into a Joliet formatted CD. 
  The sub-directory of a web file may now be part of its file name for reducing ambiguous names that differ only by an arbitrary number 
  Add the ability to signal the end of a long operation by playing an audio file 
  Add Compound-Import commands 
  Accepts and correctly imported files with space replaced by "%20" character sequence (usually from Windows-based servers) 
  Corrects default directories of File Open/Save dialogs 
  Corrects problem of double file extension when the shortcut file name contains a file extension precedint the ".url" extension 
  Corrects other minor bugs 
021015 Version 1.0_02 build 64 (Maintenance release)
  Optimization reports nb of files before and after
  webgrabber.jar can be used as a Help server and as a website copier using different OS processes
021002 Version 1.0_01 build 63 (Maintenance release)
  Capitalization handling improved
020905 Version 1.0 build 62 (Release version)
  Restructured engine
  Minor bugs solved
  Minor improvements
020823 Version 1.0 beta1 build 56
  Url Interpretation is now saved into the Shortcut list, there is no more requirement to complete the integration of imported Web files within the same session
  Revert to Named command is disabled if one shortcut item of the list has reached the Hyperlink-Adjusted state
  The Ignored flag setting of a redundant shortcut item is interlocked with those of other shortcut items sharing the same URL (this reduces user operation errors)
  Improved user error tolerance
  Improved Linux/GNOME 1.4 support
  Corrected an important bug on Linux; the List > Optimize menu command was not working properly and the resulting imported web files were corrupted.
020805 Version 1.0 alpha2 build 55; 
  Added rudimentary support for Linux/Gnome
  Corrected a bug in the List > Optimize function (if applied twice on the same root under some circumstances, some embedded files were erased)
  Improve accuracy of URL interpretation
020722 Version 1.0 alpha1 build 54: first public release

 

COPYRIGHT NOTICE

WebGrabber v. 1.1 freeware. 
Copyright ( C ) 2002 by Marcel St-Amant
By using this software you accept all the terms and conditions of this License Agreement
This software is the property of Marcel St-Amant and is protected by copyright law. There is no license fee, and registration is not required for WebGrabber v. 1.0 freeware. However, this Agreement does not grant you any rights to enhancements or updates, or support or maintenance of the product. Future versions of the product may not be freeware.
This software is provided 'as-is', without any express or implied warranty. In no event will the author be held liable for any damages arising from the use of this software. 
Permission is granted to anyone to use this software for document saving and archiving purpose, including commercial applications.
You may not modify this software in any way, nor reverse-engineer it. If you find a bug or have a suggestion, please contact the author by Email, however, this does not imply that the requested correction or enhancement will be applied.

You may distribute this software to anyone with the following restrictions:
-The origin of this software must not be misrepresented; you must not claim that you wrote the original software. 
-You must provide an EXACT copy of original package; no modification is allowed. 
-If you provide the software on your Internet site or on a CDROM, the author of this software must be clearly identified and a link to his site be provided. Please inform the author by E-mail.

Wav.exe is freeware
This command-line WAV file player "wav.exe" is copyright(c) 2001 by Dave Navarro, see "wav.txt" file. These files are included here for convenience but are not required.

Author: Marcel St-Amant
Email: bigfeet@videotron.ca
Big-Feet Software: http://pages.infinit.net/bigfeet/index.html
Montreal, Quebec, CANADA.
