What? Why? ---

• zipSurf is a CGI script to browse contents of zip compatible archives.
• Its main purpose is to allow access to javadoc Java API docs without decompressing it.
• It needs a webserver, bash and unzip, and that's all.

Features ---

• interactive directory listings on-the-fly
• aliasing archives and directories inside archives
• single archive mode -- much faster!

Notes ---

• zipSurf doesn't leave no temporary files around (isn't it great;)
• It has proved to be fast enough for daily use.
• You need to be able to run CGI. This may require adjusting server config.
• Archives are visible under friendly:P names. Their real location on the filesystem is hidden (remember to put zipsurf.list (or whatever name you choose) in a secure place or it may be obtained by some dark forces;)
• I use it behind a firewall (no public access to the web server). Therefore, I didn't care to check if it can't be abused. Suggestions about improving security are especially welcome.
• CAVEAT: If you want file listing, append a / (slash) to the location, eg. host/cgi-bin/zipsurf/myarch/somefol/

Installation ---

• Consult included file sample.wrapper.cgi. I'd recommend putting something like this in a CGI-enabled folder.
• For a multi-archive setup, you need to create a file with a list of archive paths and aliases. Consult sample.zipsurf.list.

Similar software ---

• zipserver – pure java; maybe a bit too heavy. Works well.
• mod_cwa – a module for the Apache server. The link in the Apache modules repository is broken.
• mod_ziplook – a more recent module. Seems nice;)

get it @ sourceforge.net/projects/zipsurf

mtime=Wed, 12 Feb 2003 18:39:35 +0100
mail kse at wp dot pl