HouseSpider Homepage »Project »Download

HouseSpider installation for version 4.0

Keith L. Jackson, May 2000

Slightly modified and published on SourceForge by Hans Fr. Nordhaug, January 2001

Download the Required Files

Downloads of this and later versions are best done on the SourceForge Project page but for convience you can pick them up here as well (but it might be slower):

Installing the HouseSpider Applet

The HouseSpider applet is in a jar that must be copied to the same host as your web site. In addition you need to copy one (or all) of the button jars to the same location. Make sure that you copy the file as binary format. A sample HTML tag is as follows:

<applet code="HouseSpider.class" archive="HouseSpider.jar,buttons.bevel.jar" width="90%" height="200">
 <param name="URLStart" value="">
 <param name="bgcolour" value="FFFFFF">
 <param name="fgcolour" value="666666">

The code="HouseSpider.class" is required identify the applet to run. The applet must be named "HouseSpider.class" (case matters), it will not work if its name is altered. The archive="HouseSpider.jar" is required and may include a path if you are calling the applet from a different directory The width and height should be set to a minimum of 450 * 200, I prefer width="90%" and height="200" or more. The applet tag may be followed by four optional parameters:

Check out the applet tag in this page.

Now test your site and see how it works!

Indexing Your Web Site

You need to invoke the HouseSpider applet from a command line, something like "appletviewer indexsetup.html" (the latest Java Runtime Environment is required). The file "indexsetup.html" should contain the following tags:

 <applet code="HouseSpider.class" codebase="/local/www/dir/jars/"
   archive="HouseSpider.jar,buttons.bevel.jar" width="400" height="200">
  <param name="URLStart" value="http://your.web.server/dir/startfile">
  <param name="bgcolour" value="FFFFFF">
  <param name="fgcolour" value="666666">
  <param name="SaveDir" value="/local/www/dir/">

where "SaveDir" tells where you want to save the index file "HouseSpider.index". "codebase" tells where the jar files are stored. The URL, "URLStart", may be to a local copy or remote copy of your site, but you will probably want to index a local copy of your site before you upload it to the server.

Type "houseindex" in the text input box to index your site. You may need to set the security mode for the appletviewer to unrestricted. My settings are:

If all goes well, one file will be generated, "HouseSpider.index".

After indexing, a statistics report is generated that lists how many pages that where indexed and pages with missing title tags.

HouseSpider is capable of indexing 10000 web pages and 10000 key words. Memory is not the issue, but size of the index file is. I figure that an index file of 100k will still be acceptable, but anything larger will probably be too slow in loading.


HouseSpider is free.

Open Source Code

HouseSpider is open source and being distributed under the GNU General Public license. If you decide to modify HouseSpider, and your modifications are improvements (as opposed to simple GUI modifications) please submit a patch on the SourceForge Project page


Source code for this and later versions are found on the SourceForge Project page.

Known Problems


I thank Tim Tyler for the ImageLoader class.

Valid HTML 4.0!