*****************************************************************
*                                                               *
*                           CooHunt(V1.10)                      *
*                         (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:
******************


  A). 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.


  B). Main Screen

   1). Hunt page(tab)

      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(domain)
                       (and buffer limited outside links) before it process other domans.
                       This style requires less memory slower than "All links".
                       One disadvantage is that it may miss those sub pages which can not
                       be reached from its main page.

           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 to 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 existing sub pages.


            Characters of styles:

                - The fastest one is "All links" but it requires a lot of memory.
                  If you don't have enough memory in your system, the search may
                  end up with "Out of memory" error or slow down dramatically after
                  a long period search since CooHunt keep all the links as search history.

                - The most efficient style is "Site By Site"(actually, Domain By Domain).
                  It is a little bit slow during early phase of search 
                  but get faster when each site is done.

                - If you like to find EVERY link under a url, for example all members'
                  home page in compuserve's ourworld.compuserve.com/homepages, "Sub Link Scan"
                  is what you want. It will scan an url charater by charater "physically".
                  It is slow but you will cover ALL existing links.

                - "Sub link only" search only links belong (with a high-level url path
                  as their prefix) an url. Any not related links will be ignored.

            Please report any bugs or wish by clicking at button "Bug Report"
            so that we can fix bugs shortly and add your wish to next version.      

                          
   2). Email page

      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 page

      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 page
    
      This page is not available yet and will be available in next version.


   5). Other page

      This page is not available yet and will be available soon.
      But all the searching results will be stored in the corresponding
      subdirectories. For example, class files will be stored in
      data\class.

   6). REGISTRATION page

      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.


 C). Menu

  1). File | Open

      Open function allows you to open an incomplete search and continue
      it (by clicking at button "Start Hunt" after open the search)

  2). File | Save As

      Save As function allows you to save an incomplete search so that
      you can continue the search later by loading the saved search log file
      using Load function above.  

      Coohunt will confirm if you like to save the incomplete search when you
      exit with an incomplete search.

  3). File | Exit

      Exit does the same as what Exit button does.

  4). Option | Set Option

      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). Other

        You can enable or disable all other types of searching here.

  5). Help | About

      You will see Coohont is info and registration status here.

  6). Help | General

      Clicking at menu item will open a browser with readme.txt loaded.


Tips to increase searching speed and efficiency
***********************************************

 1). Use "Site By Site" search style if you get "Out of memory" error when
     using "All links" style since "Site By Site" resquires much less memory.
 2). Don't save email by page (uncheck checkbox "One page per block" in option dialog)
     and increase field "Num found verify" and "Num found in memory"so that Coohunt 
     process email duplicate verification in larger blocks.

 3). Adjust "number of life threads" to match your system.

 4). Adjust java.exe or jre.exe parameters to match your system.

 



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 Coohunt stops(hangs) after searching for a while and a "out of memory"
     error message is shown in the console window(the dark window), you need to
     increase memory for Java Virtual Machine by 
     increasing the -mx and -ms flags in coohunt.bat

     For Example, change coohunt.bat to: 

     jre -mx16000000 -ms8000000   -classpath .;.\symantec\SYMBEANS.JAR;c:\Progra~1\JavaSoft\JRE\1.1\lib\rt.jar coohunt

     or larger

     jre -mx32000000  -ms16000000  -classpath .;.\symantec\SYMBEANS.JAR;c:\Progra~1\JavaSoft\JRE\1.1\lib\rt.jar coohunt

     
     After you change  -mx and -ms, you get "out of memory" right
     after you start CooHunt, that means that you don't have enough
     memory to assign to Java Virtual Machine. You need to increase 
     Virtual Memeory of your machine as needed.

     For example,  seting -mx32000000  -ms16000000  
     requires Vitural Memeory size to be set to at least 200MB.(Please
     open panel | System | Performance to change your Virtual Memory)

  3). Another way to get around the out of memory with limited memory is
      saving current search after you get "out of memory" error. Move or
      delete some resource buffer files such as image buffer files.
      Then, load the saved search and restart the search. 

  4). 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.
