*****************************************************************
*                                                               *
*                           CooHunt(V1.03)                      *
*                         (For WinNT & Win95)                   *
*                         Written by Mark Qian                  *
*                       Coolshare Consulting Inc.               *
*                          All rights reserved                  *
*                                                               *
*****************************************************************



CoolHunt is a cool automatic navigator and search engine.
It allows you search for email addresses and send found emails while searching.
It also allows search for images, audio files, and class files.
Just A clicking at images will take you to the related linked page...
Image printing and filing are also available.
and more!!


Environment Requirements:
***********************

  Operationing System: NT4.x (or later) or Win95
  Java:  JDK1.1.5 or later

  Note:

    If you don't have a Java environment, you may want to go

    http://java.sun.com/products/jdk/1.1/jre/index.html

    to download and install JRE (Java Runtime Environment) 1.1.x .

    

Installation instructions:
*************************

   unzip coohunt.zip, say to c:\tmp\coohunt,
   you will see following 

   c:\tmp\coohunt\Coohunt       (a subdirectory)
   c:\tmp\coohunt\coohunt.bat   (the file you run to launch CooHunt in a JRE 1.1.x environment)
   c:\tmp\coohunt\coohnt2.bat   (the file you run to launch CooHunt in a JDK 1.1.5 environment)
   c:\tmp\coohunt\readme.txt    (this file)
   
  
How to use CooHunt:
******************


  0). Run CooHunt

      a). If you have JRE 1.1.x installed in your system, 
          double click at icon of coohunt.bat in Windows NT or Win95 
          to launch CooHunt.

      b). If you have JDK1.1.5 in your system,
          double click at icon of coohnt2.bat in Windows NT or Win95 
          to launch CooHunt.


      Note: if you get errors like

         "Unable to initialize threads: cannot find class java/lang/Thread"

        see "Troubleshooting" below.


  1). Hunt screen

      This is the main control panel of CooHunt. You can select what to
      search and how to search here.  CooHunt allows you search
      Email addresses, image links, audio links, and others at the same
      time.  You need to enter a "seed" URL such www.yahoo.com, to start your search at.

      CooHunt provide a variety of search styles:

           All links - CooHunt picks whatever links it meets for its next step 
                       with only key word preferance. 

           Site by site - CooHunt finishes all the subpages in a site 
                       (and buffer limited outside links) before it process other sites.

           Sub link only - Coohunt only processes sub pages of the seed site.

           Sub link scan - CooHunt "physically" try charactors one by one to find 
                       potentail pages. For example, if you set length of searching
                       to 8 and start at "ourworld.compuserve.com/homepages", it 
                       will try 

                          ourworld.compuserve.com/homepages/a
                          ourworld.compuserve.com/homepages/b
                          ...
                          ourworld.compuserve.com/homepages/z
                          ourworld.compuserve.com/homepages/aa
                          ourworld.compuserve.com/homepages/ab
                          ...
                          ourworld.compuserve.com/homepages/zzzzzzzzz

            You can specifiy prefix such as "~" so that you can search
            an ISP's and find all its users' homepage such as
                www.best.com/~abc
                         
            This is a very useful style.  Although it may be slow but it
            will cover all the potential sub pages.
                        
 

  2). Email screen

      You will do your email searching and posting here. You can start Auto Mail so that
      CooHunt posts email for you while it's hunting for email addresses.

      You can also send a particular item or block.

      An email Editor will be poped up if you try to mail but no content is ready so
      that you can enter your email or load it from a file.

      CooHunt includes something interesting: Junk Mail Defanse.  If you are bothered
      by junk emails(sent by CooHunt?!), it may provide an efficient way to "kill"
      the mailer's incoming mailbox(if you really know the maller's email address)
      by filling up mailer's mailbox with junk mail.  That is, this function allows
      you send thousands of email to a specified email address. 

      
  3). Image screen

      You hunt for image URLs in this screen. You can start hunting by clicking
      at "Auto Show" button(If you only see "Stop Show" button that means that
      you have started Image hunting). Or you can click at "Start Hunt" button(If you only
      see "Stop Hunt" button that means the hunting has been started).
      There are two ways to view found images: you can either allow Auto Show to 
      show you found images one by one after clicking at "Auto Show" button or
      you can click at the list or arrows to see a particular iamge in the image list.
      Note: when you click at any button of list, Auto Show will be stop. You need to
      click at the "Auto Show" button again to restart it.

      Filing image function only support regular GIFs. To file a GIF89(animated GIF)
      or jpg files, click at button "Original Image" and you will see a browser
      is opened. You can then save the image from the browser(choose File | Save from
      the browser menu).
              

  4). Audio screen
    
      This page is not available yet and will be available in next version.


  5). Class screen

      This page is not available yet and will be available in next version.


  6). REGISTRATION

      The demo will be partially disabled after you view 500 images or send 300 emails.
      You can enable CooHunt by register it in this screen.  Registration
      is only a click away. Just following the Step-By-Step instructions in the registration
      screen to register.


  7). Option Dialog

      Option dialog is a place where you customize Coohunt.
      You can open option dialog from Coohunt's menu Option | Options.
      
      There are four pages in option dialog:

      a). General
        
        You can customize all the name of buffer files and directories.
        Since your machine has limited resouce such as memory and disk
        space, you can set up a proper number of live threads, maxmum number
        if threads(only live  thread can do searching task while the rest
        of threads are put in to "sleep"), size of buffering files (Please
        don't set them too big to fit in to list boxes), period of thread sleeping,
        
        

        You can clear all the buffer files by clicking at "Clear All Logs" button.

      b). Email

        CooHunt makes sure that no redundant email is sent by checking redundancy
        against sent email addresses stored in buffer files.
        Coohunt will discard sent block(a set of email addresses stored in a file)
        after sending them if you check box "Remove Sent email". This may increase
        the process speed but it may cause that CooHunt sends redundant mails.
        The similar things happen if you remove sent mail by clicking at button 
        "Remove Sent Email".

        You can clear email buffer files by clicking at "Clear Email Logs" button. 

        There are two ways to send email: 

          a). sending email directly from CooHunt.  Sending mail in this way is
              simple.  You only need to specify your Outgoing Mail(SMTP) Server.

          b). if there is a firewall between your browser and your server, you may
              need to send email by a cgi script, coohunt.cgi under CooHunt\CGI directory.
              You need to install it in your server. You also need to specify the
              url of coohunt.cgi.

      c). Image

        Coohunt can either discard the current block(a set of image URL stored in a file)
        when you switch to next block or keep them. You can choose from one of them using
        the check box labeled "Removed read image" in option dialog.

        Coohunt can also remove redundant items in a block by checking box "Remove redundant
        items in a block" but this may slow down its  process.

        You can clear iamge buffer files by clicking at "Clear Image Logs" button.      
      
      d). Audio

        This page is not available yet and will be available in next version.
      
      e). Class

        This page is not available yet and will be available in next version.



TroubleShooting
***************

 1). if you get errors like

         "Unable to initialize threads: cannot find class java/lang/Thread"

    That means that the path in coohnt2.bat to Java's lib is not the one in your system.
    Please search classes.zip and replace c:\jdk1.1.5\lib\ in coohunt.bat with
    the corrent path. (You may want to use a text editor to edit coohunt.bat)

    Or Please search jr.jar and replace c:\Progra~1\JavaSoft\JRE\1.1\lib\ in coohunt.bat with
    the corrent path.

    If no classes.zip nor jr.jar is found, you need to go

        http://java.sun.com/products/jdk/1.1/jre/index.html

    to download and install JRE (Java Runtime Environment) 1.1.x .   

    If you find more than one classes.zip, please make sure you use
    the path for jdk1.1.5 or later.

 2). If you don't have enough memory allocated to the java runtime. That is, if
     the running program ends up with "Out of memory"(you can see this message in
     the DOS console - a dark window opened when you run coohunt.bat)

     To fix this, increase the memory allocated to the java runtime by 
     increasing the -mx, -ss, and -oss flags in coohunt.bat

     For Example: 

     java -mx32m -ss32m -oss32m [Rest of command] 

     You also need to increase Virtual Memeory of your machine as needed.

  3). If you install a later version and no CooHunt window is popped up
      after you doule click at icon of coohunt.bat(you may only see the console
      window), you need to close the console window and delete the previous
      ini file at ./CooHunt/classes/coohunt.ini (If you get a delete permission
      deny error, you may want to exit Win95 or NT and delete it after you reenter)

 
This may not be the latest version. Please go to author's home page
http://www.coolshare.com

to get the latest version and more BETTER applets and COOL screen 
savers with screenshots. You can reach the author at 
Internet: ok@coolshare.com or
mail the author at: P.O. Box 390235, 
Mountain View, CA. 94039-0235.
