RR Thumbnail Generator README
-----------------------------
Copyright 2002 by Rudy Rudy.
All rights reserved.

Thumbnail Generator is a PERL script I wrote that generates thumbnails for a directory of images. The directory MUST contain only images (no text files, no html, etc). The script provides a very simple, easy and quick way of making thumbnails. It even creates an index.html file that tabulates all the thumbnails. Sure enough, there are many software out there that can do this (ex: Adobe Photoshop), but they cost a fortune, while this is completely FREE! The only catch is: before you can use the script, you might need to install a number of things. But believe me, once you are done, it will be worth it!

Namely, you will need to install:
- PERL Interpreter 5.6
- ImageMagick 5.4 (with PerlMagick)

You might want to print this page for instructions.


Linux/Unix Computers
--------------------
Since you are a Linux/Unix user, I am assuming that you know a lot about what to do. Your system will most likely have the PERL interpreter already, so you will only need to install ImageMagick. Go to: http://www.imagemagick.org to get and install the software. Once you are done, don't forget to also install the PerlMagick module.

After installing the PerlMagick module, download the RR Thumbnail Generator tar file, extract it and save tn_generator.pl anywhere you like (preferably in /usr/local/bin or other directory that is on the user's PATH). To use it, make tn_generator.pl executable (i.e. 'chmod u+x tn_generator.pl'), and make sure that the directory contains ONLY images. Execute tn_generator.pl, enter the directory name and title of the index page when asked.


Windows Users
-------------
Follow these instructions closely to install all the necessary programs to run the RR Thumbnail Generator script:
  1. If you are using Win95, Win98 & ME, you will need to first upgrade to Windows Installer v2.0. Click here to download (1.7 MB).
  2. Download and install Active PERL 5.6 (8.6 MB).
  3. Download and install ImageMagick 5.4.9 (4.1 MB).
  4. When installing ImageMagick, make sure you select to install PerlMagick (it's not the default).
  5. Download the RR Thumbnail Generator Script for Windows zip file (tn_generator.zip).
  6. Extract the zip file (you can use Winzip - if you don't have it, you can obtain it from my Cool Stuff page
You will have tn_generator.pl among the extracted files (this is the RR Thumbnail Generator Script). You can save this script anywhere you like. To use it, put the directory that contains images on the same folder as this script. Execute tn_generator.pl (by double-clicking). Enter the directory name and title of the index page when asked.


Notes
-----

And as with all my shareware, you are welcome to modify the source code as much as you like (that is why I am sharing it!). However, if you should decide to do so, please have your modified code referenced to the original one (i.e. my website: http://www.rudyrudy.com). That's ALL that I am asking.


Rudy Rudy
September 27, 2002