What is imgSeek ? 
=================
imgSeek is a GNU/Linux photo collection manager capable of searching through an image 
database, in which the query is expressed either as a rough sketch painted by the user 
or as another image you supply (or an image in your collection) 
The searching algorithm makes use of multiresolution wavelet decompositions of the query
and database images. 

Installing
==========
Untar the downloaded archive:

$  tar -zxvf imgSeek-0.6.tar.gz

The contents will be placed on a directory called "imgSeek".

To install, enter the imgSeek directory where archive contents 
were extracted to and type, as root:

#  ./install

Install Problems
================
Please refer to http://imgseek.sourceforge.net/requirements.html
for more details.

If you still couldn't run imgSeek, please email 
"imgseek-devel@lists.sourceforge.net" with the setup.py and g++ output.

Running
=======
To run imgSeek type:

$  imgSeek


Features 
========
You simply draw a rough sketch of what you want to find and imgSeek displays for you a
thumbnail view of the best matches.
Automatic thumbnail generation and caching. Using this standard, which is also used by Gimp, Nautilus/Gnome, Rox Desktop, gThumb and others. 
Query images similar to one in your collection by double-clicking on it's thumbnail.
Group your photos by similarity.
Edit metadata (description, camera, lens, etc) for every image, and use them on the HTML albums generated or for searching photos. EXIF data found on JPEG files are automatically imported. 
Slideshow for a given directory, whole collection or for a chosen group of similar images.
Generate HTML albums for the entire collection, a given directory or similarity group
Advanced keyword searching for metadata.
Organize and browse pictures in groups with an easy drag & drop interface.
Support for multiple volumes of pictures. You may assign all images on a CD to a given Volume
Supported file formats are jpg, gif, bmp, png, xbm, and pnm
Add images to the database from a directory recursively.
User friendly interface that remembers typed queries and drawn sketches for later usage.
Browse images by thumbnail and view them on a preview window.


Requirements 
============
These instructions apply to all GNU/Linux systems. 

- Python - Download here.
- Python development files 
- PyQT 3.5 - Download here.
- QT 3.x 
- QT development files
- ImageMagick and it's development files (optional: Will add support for more image formats)

All GNU/Linux distributions provide these requirements. Use your distribution's .deb/.rpm/.ebuild/etc... If you have any problem installing imgSeek, feel free to email me. 

Running
=======
To run imgSeek type: $ imgSeek 


File list for the source distribution (mainly CVS): ** not updated **
======================================
Filename                    Description
=========================== ================================
AUTHORS                     Developers List
COPYING                     License terms
ChangeLog                   What/who/when was changed during development
THANKS                      People who helped imgSeek so far
TODO                        What's left to do
Tools/imgSeekCmd            Command line utility.
builddistwin.bat            Generate win32 distribution dir
buildext                    Alternative script for building the necessary extension modules
imgSeek                     The program itself
imgSeek-*.ebuild            Gentoo ebuild (Please tell me if it works so I can submit it to bugs.gentoo.org)
imgSeek.desktop             Some desktop environments may use it
imgSeek.lsm                 Linux software map standard description of imgSeek
imgSeek.nsi                 Nullsoft installing system script
imgSeek.pro                 QT project file for building translation files
install                     Shortcut for "python setup.py install"
intl/*                      Files needed for translation
imgSeekLib/*                Core source files
imgSeekLib/styles           HTML album templates
setup.cfg                   Python distutils config (for RPM bdist)
setup.py                    Main install script
win32dlls.zip               Necessary DLL's on windows. (All included on a final release distribution)


Bug reports and contact 
=======================
Please submit any bug reports, suggestions, comments and rants to nieder|at|mail.ru or one of the mailing lists.
