# README

# Ekspos Image Viewer

## Contents

- What is it?
- Installation
- Copying
- Information
- Bug Reports and Feedback

## What is it?

> Ekspos is platform independent Java image viewer program. It support most popular image format: JPEG, PNG, and GIF, where additional image format can be added through Java ImageIO plugin. It consists of 2 parts: shell browser and viewer. Shell browser allows you to navigate your image collection and you'll be able to browse images in tree, detail, list, icon and thumbnail view. The viewer provide progressive view of images with zoom and pan capability.

> Features:
> - Image Format(Standard): JPEG, PNG, and GIF
> - Support Java ImageIO plugin
> - Support 4 views: detail, list, icon, and thumbnail
> - Thumbnail caching for fast preview
> - Written entirely in Java™

## Installation

> Note: You need to have J2SE or Java VM (JRE) 1.5 or above. You can download from Sun Java site (http://www.java.com/getjava)

> To run the program:
> - go to "[install_dir]/bin" directory
> - on Microsoft Windows double click ekspos.exe or type "ekspos.bat ["optional startup folder"]"
> - on Linux/Unix type "ekspos.sh ["optional startup folder"]" or change the permission first +x if necessary
> - on other type "java -jar [install_dir]/lib/ekspos.jar ["optional startup folder"]"

> Note:The optional startup folder is optional. If left empty it will use USER_HOME as startup folder. If relative path it will resolve against the current directory. For directory or folder contains spaces please use double quotes.
> eg:
> ekspos.bat "c:\my folder with space\my picture\"
> ekspos.bat "...\..\picture folder\"

> To compile the program:
> - make sure you have ant or you can download it from http://www.apache.org
> - on [install_dir] type "ant" to get the list of option available

## Copying

> The use of this program is bound and protected by revised BSD license,
> please read "[install_dir]/legal/LICENSE.ekspos.txt"

> This program also includes 3rd party libraries/components.
> Please read all the LICENSE files on "[install_dir]/legal/" folder or directory.

## Information

> The latest news about Ekspos can be found on:
> - http://www.kiyut.com/products/ekspos/index.html

## Bug Reports and Feedback

> For bug reports and feedback, please send email to support@kiyut.com.
> If possible please include details of your development environment, steps to recreate the problem
> and attach any examples you have where applicable.

> Your feedback is important to us.