Gratis Photo Viewer

A web-based photo gallery that can be easily integrated into your website. Includes server-side image processing script that can be run on the command-line or by cron job.

Check out the online demo at: http://mbrooks.info/demos/gratis-photo-viewer

Features

Extensible XHTML/CSS interface.
Template based output.
Command-line parsing tool.
Compatible with Internet Explorer, Firefox, Safari, Chrome, and Opera web browsers.
Supports JPEG file types.

System Requirements

Apache 1.3.x or 2.x
Perl 5.x
ImageMagick 6.x
Cron or event scheduler
mod_rewrite (optional)

Installation

FTP Client

Download the latest sources to your computer using a web browser.
Extract the contents of the .tar.gz into a folder on your local computer.
Upload the folder to your webserver.
Change the permissions for the following files and folders:

Filename	Mode
galery	777
config.txt	755
install.pl	755

From within your web browser, run the install.pl

Command-line

1. Download the source archive to your web server using the ''wget'' or equivalent command.

wget http://trac.mbrooks.info/gratis-photo-viewer/browser/branches/gratis-photo-viewer-x.x.tar.gz

2. Extract the contents of the ''tar.gz'' on your web server.

tar xfz gratis-photo-viewer-x.x.tar.gz

3. Change the permissions for the following files:

chmod 777 photos
chmod 755 process.pl viewer.pl

4. Modify the configuration (config.txt) and crontab (stuff/crontab).

5. Install the new crontab.

crontab stuff/crontab.txt

6. Remove the installer script.

rm install.pl

Create a photo gallery in 3 easy steps

Create a new directory (example: My Gallery) in the photos directory.
Using an FTP client, upload photos to the new directory.
Run the Image Processor from either the command-line or crontab.

Using the command-line image processor

To manually parse images on the command-line:

./process.pl --dir /path/to/htdocs/gallery/photos --small 50 50 90 --medium 80 80 90

To automatically process new images. Add the following lines below to your crontab.

*/5 * * * * /path/to/htdocs/gallery/process.pl --dir /path/to/htdocs/gallery/photos

Code repository

This project's repository can be checked out through ''SVN'' using the command:

svn checkout https://gratis-viewer.svn.sourceforge.net/svnroot/gratis-viewer gratis-photo-viewer

Maintainer

For feedback, bug reports, or other comments, please contact me at: devel at mbrooks dot info

License and warranty

This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

Gratis Photo Viewer is provided under the terms of the BSD "Free as in Beer" license.