                                CatchFiles by Claudio Santini


CatchFiles is a software that allow the user to download files over the internet. Also resuming 
of interrupted downloads is possible if the server from which the file is being downloaded 
supports resuming. This is possible both from HTTP and FTP servers. 
Thanks to the Java technology CatchFiles is a relatively light program comparing to other 
programs of the same type. 
To use this program you must have installed a Java Virtual Machine 1.1 or later, that could be the Java 
Developer Kit (JDK), the Java Runtime Environment (JRE) or simply you should have installed on 
your PC Microsoft's Internet Explorer 4.0 or later. CatchFiles can be used both on Windows 
(95,98 or NT) or on Linux. 
On Windows systems the Setup (also written in Java) will recognize which Java Virtual Machine you
set on the PATH and will install a convenient batch file to run the program. 
If you don't own one of the above Virtual Machines you can download the bundle that includes
Sun's Java Runtime Environment. Check my  site  for it. 
CatchFiles is made up of three main windows : the ResumeList, the CatchFile and the Monitor. 
The ResumeList is the window where you can resume interrupted downloads and where you can acceed 
to the other two windows. 
The CatchFile is the window that is opened when the download is under progress and where you can 
see the progress. 
The Monitor gives you the possibility to download while surfing the net with your favourite 
browser, infact it would be sufficient to right-click and copy the link address and the download 
will automatically start. 
Among the various useful options is to open the file using the system default program as soon as 
the download is termintated. You can set this option to be on demand or automatic or you can 
disabled it. 
                            
 __________________________

        Registration
 __________________________


After 30 days of evaluation the program will cease to work and you are required to register.
To continue using the program you must pay the registration fee established in US$ 12.50 for non
EU citizens and Euros 11.50 for EU citizens (see conversion in other currencies). 
If you decide to register and your CatchFiles is going to expire, please E-mail me at 
buasaard@tiscalinet.it I will send you a new program which allow you to use it for another 30
days. After the receipt of money I will send you a registration code that will allow you to use
the program without limits. You will also be entitled for free upgrades. 

Presently it is not possible to use credit card for payment. You can use instead this means of
payment : 

-Postal order 
-International non transferable check (ordinary non transferable checks if you reside in EU countries). 
-Bank transfer to account: 
 2756839/01/85 Banca Commerciale Italiana - ag. 14 Roma.(it is essential you advise me by E-mail). 
-Cash

The payment must be sent to : 

Claudio Santini 
Via Emilio Longoni 19 
00155 Roma 
Italy 


 __________________________				
                           
  Technical requirements  
 __________________________


This program has been tested on Pentium systems on Windows95 and Linux OS. The minimal machine 
was a Pentium 133 with a 16Mb RAM. The software uses approx. 5.4 Mb RAM. 
You need also a Java Virtual Machine 1.1.3 or later. You can use either the JDK, the JRE or the 
JVM built in Microsoft's browser IE 4.0 or later. 

 __________________________
                          
       Installation          
 __________________________     


YOU INSTALL ON LINUX


    - unzip to a temp directory the zip file
    
    - edit the file /etc/profile or whichever contains the environment variables

    -check that the PATH contains the /bin directory of the JVM, and the CLASSPATH the runtime
     classes otherwise set them. 
     For instance if you have the JRE in the /var/local/JRE the PATH will be:
     PATH=/var/local/JRE/bin
     then the CLASSPATH will be:
     CLASSPATH=/var/local/JRE/lib/rt.jar
    -in the same file you should have a line of EXPORT the variables. If you haven't add a line
     EXPORT PATH CLASSPATH
   
    - If you modified the file reboot the system

    - from the command line enter in the temp directory and type (in XWindows):
      a) you have JRE 1.1x : jre -cp CF.zip ResumeList S;
         you have JDK 1.1x : java -classpath CF.zip ResumeList S;
      b) follow Setup instructions.

    -add to the CLASSPATH the CF.zip file of the installation directory/classes. Let's assume you
     installed CatchFiles in the /usr/CatchFiles directory, the new CLASSPATH will be:
     CLASSPATH=/var/local/JRE/lib/rt.jar:/usr/CatchFiles/classes/CF.zip
  
    - Reboot the system


YOU INSTALL  ON WINDOWS

   -  Unzip the file in a temp directory and then run the Setup.bat file, then follow the 
      instruction of the Setup program.

				
 __________________________
                          
   Running  the Program   
 __________________________      


To run the program it is very easy, however we must distinguish the way if you are using Windows 
or Linux. 

Run under Windows 

To run the program under Windows (either W95-W98 or NT) simply click on one of the two starting 
files on installation directory or on the desktop (the files are CF or CFMonitor).
The CF file runs the program in the ResumeList mode the CFMonitor in the monitor mode. 

Run under Linux 

Provided that you followed all the steps indicated in the installation instructions from the 
prompt (you must stay into XWindows) enter into the installation directory. 
Then type : 
a) If you have the JDK : java ResumeList R (for the ResumeList) or java ResumeList M(for the Monitor) 
b) If you have the JRE :  jre ResumeList R or jre -cp /CF.zip ResumeList M . 

Now the program will start. 
  
				
 __________________________
                          
          Howto          
 __________________________ 


a) Download a new file

   1) from the ResumeList;
      a) select "File","New" or click on the first icon from the left;
      b) in the new Window type the URL address of the file you want to download;
      c) click on the start button;
      d) Save the file on your computer, the program provides a default name, you can change
         as you like.
   2) from your favourite browser;
      a) open the Monitor from the Resume List ("File","Open Monitor") or clicking on
         the CFMonitor.bat file in the installation directory or click on the 4th icon;.
      b) from your favourite browser window, click with the right button of the mouse and choose
         "Copy link address" or whatever your browser provides for copying links.
            
      
b) Resuming an interrupted download

      1) From the Resume List select the file you want to resume 
      2) click again on the line.

c) Delete an interrupted download

      1) From the Resume List select the file you want to delete
      2) choose from the menu "File","Delete" or click on the 3rd icon
      3) you will be requested to confirm the deletion
      4) choose "yes"

d) Setting preferences

      From the menu "Edit","Preferences" you can set various preferences namely:

      From the "General" Panel
      1) The download directory which is the directory where the system saves the files by
         default;
      2) The registration code.

      From the "Connections" Panel
      3) The timeout - "Wait before retrying" is the time that the program waits between 
         attempts to download the file
      4) Number of tries. The maximum number of times that the program will try to connect
         to the server.
      5) Find IP Method.
         When downloading files from FTP servers, the server must know your IP address to send 
         you the file. Usually the "Auto" option will work perfectly, however in certain cases
         (expecially working with workstations) the program is unable to recognize your IP 
         address.
	 If you have a fixed IP address, select the "Fixed" option. A text field will appear. You
         can enter there the IP address in the form of 4 numbers separated by a point
         (e.g. 125.158.1.10).
	 If you have a dynamic IP or simply you don't know you can select the option "Search". In
         the text field type your E-Mail server (the one you write in your E-Mail client such as
         Eudora, Outlook, Netscape messenger etc..). If you don't have an E-mail, you can type 
         any mail server. Usually a mail server address is a 3 words address starting with "mail" (e.g. mail.
         yourserver.com). This is valid for most famous WebSpace providers. In Windows95 and 
         Windows98 leave the "Auto" option selected, if you cannot download from FTP servers, you
         can change the setting from the Options settings later.
 
      6) Automatic reconnection. By checking this box the program will try to reconnect any
         time the server disconnect the download.

      From the "Downloads" Panel
      7) E-mail address for anonymous FTP. It is needed to download from FTP servers.
      8) Max downloads at same time. The maximum number of downloads that the system can perform
         at the same time.
      9) View Files after downloading. If you choose yes the program opens with the default pro-
         gram the just downloaded file, if you choose prompt you will be prompted for an action.

      From the "Graphics" Panel
      10) Show Text-Area; choosing yes in the download windows will be shown information sent from
         the server, it can be useful if you don't manage to download to understand what is going
         on.





 __________________________			
                          
     Troubleshooting      
 __________________________ 

           
You can't download from FTP servers in Linux, 
when setting the local port the download restarts. 

Go to "Edit - Preferences" menu.. In the connection tab select the "Find IP Method" as Search.
then follow indication given in howto.. for the Find IP method.

			
				------------

After starting the program the Resume List or the 
Monitor do not show. 

Go to the prompt window (DOS for Windows) and start the program from the command line: 

 a) the system doesn't start but no message is shown; 
          Most probably you have deleted the resume.ini file. Create a blank resume.ini file (on 
          Linux be careful it is case sensitive). 
 b) the program sends an Array out of bound Exception; 
          One download has been interrupted not properly. Edit the resume.ini (preferably from 
          the  WordPad) and delete the incomplete line. A complete line is made of three elements
          separated by commas (the name of the file stored on your PC, the length of the file  
          and the URL). 
c) the program sends a String out of range Exception -17; 
          You deleted the Preference.ini file. You must reinstall the program. 
				--------------


For any other problem you can E-Mail me at the following address : buasaard@tiscalinet.it 

Your request must contain indication of: 

Your Operating System 
The Java Runtime you are using (JDK,JRE,MSIE) 
The CatchFiles version and language. 
A description of your problem 

				

 __________________________
                          
        Known bugs              
 __________________________

The CatchFile window shows a negative percentage 
of download 

This happens for big files. When reached about 12 Mb for the same file, the percentage becomes 
negative. Anyway the download is not affected, it is only a visual problem. 

When clicking on one heading of the ResumeList 
whose contents it's a numeric field, the program 
sorts the rows as if it were a String field. 

The problem is known. I will try to remove it in the future version. 



Please advise other bugs to the following address: 
buasaard@tiscalinet.it 


 __________________________
                           
          History               
 __________________________


Version 1.1

1) Fixed connections bugs
2) Added a buttons panel
3) Added the "Find IP Method"
4) In Windows there is now only one Setup program that recognize which JVM is set on the PATH
5) Added start files on the installation directory and on the Desktop in Windows
6) Classes are in a Zip file
7) Uninstall feature added
8) Automatic search of a file linked from an HTML page.


-End-



