picJar v0.0.4
-------------

picJar (Pictures for Jarpatus ;-) is PHP script for creating easy and
clean photo gallery to web. picJar is inspirated by picKLE - I like
it's clean look, easy usage and fastness. Actually first I took source
code of picKLE and started to modify it but after a while I realized I
had rewritten all the code. So I decided to create my own project.

picJar is designed to be clean looking, compatible and easy to use. You have
just to upload your pictures to album-directory and youre off. Installing
picJar should also be straight enough - just unpack package to you web-space
(please check that requirements are met) and do some simple
configuration.

Features
--------
* JPG, PNG GIF, BMP, XBM and XPM thumbnailing support
* Video file thumbnailing support (using mplayer)
* EXIF tag support for JPG (including some digital camera specific extensions)
* Auto rotation (orientation information from EXIF-tag)
* Basic binary file support (displays information about file)
* User selectable resampling support
* Cached thumbnails
  - Single dir caching makes it possible to move files from folder to
    another without creating new thumbnails every time (for slower
    computers)
* Autorename support
  - Renames your files using file modification timestamp. Useful when
    your digicam outputs files with previously used filenames after erase

Requirements
------------
* Web Server
* PHP >= 4.3.0 with GD library, mime_magic library OR file shell command
* PHP 5 will not work (need to fix this)

Installation
------------
* Unpack picJar to your web space (you have to be able to run php-scripts).
* Edit config.php
  - Please make sure that if you enable SINGLEDIR_CACHING, all of your 
    pictures MUST have unique filenames or thumbnails will be messed up
  - Please be carefull with AUTO_RENAME. It will rename your files
    automaticly if enabled.
* Make cache/ folder www-server writable (ie. chown www-data cache)
  If you enable AUTO_RENAME, make also albums folder www-server writable
* Optionally edit template.*.html files for look and feel customization
* Put some pictures to albums/ folder
* Fire up your web browser and see results

Problems
--------
If you are having any problems or questions, please contact
jarpatus+picjar@iki.fi .

Demo
----
http://keitin.net/jarpatus/gallery/index.php

Download
--------
http://keitin.net/jarpatus/projects/picjar/files/picjar.tar.bz2