Wise Gallery

This is Java based server side gallery software which makes web image albums automatically on the fly. All you need is just upload your favorit images by FTP and all further job will be made for you immediately. The main functionality inspired by the different existing and outdated projects, so far no one of them provides features set requred to easy and simple way to manage and customise images gallery view with combination of simple image manipulating. To see a brief description about how to install, configure and customize your gallery read more...

Main Features
Installation: Requirements; Configuration
Customization
Example, contact, sources

Main Features

Simple image upload. You need only FTP client to manipulate with your gallery.
Original images stay untouched.
Albums are simply represented by the directory structure.
Cutomizable Album tumbnails.
Image and album titles can be assigned indidvidually by the .properties file
Albums can have individual thumbnalis.
Easy albums navigation using tree directory structure.
Images can be resized and all verisions are cached and updated on demand.
Watermark can be added to every image and can be customized per album and/or image.
You are free to change the whole gallery design by you wishes.
No POSTS, sessions or cookies required! Every page and image have direct link and you can be sure that person who receive your link will see exactly the same.

Installation

To install gallery you need download the WAR file and deploy it at your application server. Current version can be get from here: Gallery.war. After simple configuration tuning your gallery will be ready to use.

Requirements

For image processing gallery use additional programs from the ImageMagick package, which must be installed at your system. Current Gallery.war package tested at the Tomcat5.5 environment, so you need to choose application server with the same set of features (i.e. Java 5 support).

Configuration

Save your configuration file before making update!

before you start using your gallery you have to configure some variables in the configuration file. This file could be find at the Gallery's web application home in [Gallery home]/config/config.properties. Format of this file is simple and easy to understand:

image.dir=[place path to you image directory here]
theme=default
cache.dir=[place path to directory where images will be cached]
name=[your gallery name]
thumbnail.width=120
thumbnail.height=120
#Followed threee lines defines path to imageMagick utilities:
convert=/usr/bin/convert
identify=/usr/bin/identify
composite=/usr/bin/composite
default.size=800x600
allowed.sizes=320x240 640x480, 1024x768, 1280x1024
#[path to watermark file relatively to the image.dir]
watermark=.watermark.png
#Watermark dissolve in %
dissolve=15
#Watermark positioning (possible values are:
# NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast)
gravity=SouthEast
#Use background resize thread
background.resize=yes
#create thumbnails in background
background.resize.thumbnails=yes
# create resized images in background
# BEWARE! it will consume much HDD space and CPU time if you set this value to "yes".
background.resize.images=no

After that you can upload your images to the image.dir and access them from web. Just point your browser somewhree like: http://[my web site address]:8080/Gallery/

Customization

you can define some properties for per file and/or album in your gallery. To do it you can just place the [directory or file name].properties file in the directory where you file located. Every .properties file can contain few options:

alt=[name wich will be use in image alt attribute]
title=[name used for title attribute and title for the web page]
watermark=[watermark file (leave blank i you do not want to add watermearks)]
thumbnail=[file used as album icon]

Note: thumbnail parameter only applicable for albums,watermark and thumbnail filesnames must be relative to the image.dir path configured in main config file.

Example Gallery

To see an example of the gallery from the real life you can visit my personal photos gallery with default installation here.
Please contact me at < deribin at gmail dot com > if you have any suggestions, questions, etc
Sources available here

ChangeLog

Version 0.3.2

Temlates cleaup to change HTML code valid by the "HTML 4.01 Transitional" rules.
Add background Image and Cache watchers threads to syncronize images repository with cache

Version 0.3.1
Small changes and bugfixes in Gallery:

Album view now reloads dynamically. This will speed up browsing on big galleries
New thumbnails layout for albums.
Fixed favicon file handling
config file now called config.properties
New config parameters for watermarks: [i]dissolve[/i] and [i]gravity[/i]
Better error handling for thumbnail generation
Using JCL logging
Code for image processing separated from models

Save your configuration file before making update!