pyGTKtalog 0.8
==============

pyGTKtalog Linux/FreeBSD program for indexing CD/DVD or directories on
filesystem. It is similar to gtktalog <http://www.nongnu.org/gtktalog/> or
gwhere <http://www.gwhere.org/home.php3>. There is no coincidence in name of
application, because it's ment to be replacement (in some way) for gtktalog,
which seems to be dead project for years.

FEATURES
========

- scanning for files in selected media
- generating thumbnails
- tagging files <http://en.wikipedia.org/wiki/Tag_%28metadata%29>

REQUIREMENTS
============

pyGTKtalog is written in python with following dependencies:

- pygtk <http://www.pygtk.org>
- pysqlite2 <http://pysqlite.org/> (unnecessary, if python 2.5 is used)

Optional modules:

- PIL <http://www.pythonware.com/products/pil/index.htm> for image manipulation
- pyExcelerator <http://sourceforge.net/projects/pyexcelerator> for export to
  excel capability

Additional pyGTKtalog uses EXIF module by Gene Cash which is included in 
sources.

pyGTKtalog extensivly uses external programs in unix spirit, however there is
small possibility of using it Windows (probably with liitations) and quite big
possiblity to run it on other sofisticated unix-like systems (i.e.
BeOS/ZETA/Haiku, QNX or MacOSX).

INSTALATION
===========

All you have to do is:

- put pyGTKtalog directory into your destination of choice (/usr/local/share,
  /opt or ~/ is typical choice)
- modify pyGTKtalog/pyGTKtalog line 4 to match right directory
- copy/link pyGTKtalog/pyGTKtalog shell script to /usr/bin, /usr/local/bin or in
  other place, where PATH variable is pointing or you feel like.

Then, just run pyGTKtalog script.
  
TODO
====

For version 1.0 following aims have to be done:

- searching database
- tagging files
- filetypes handling
	- movies
	- images
	- archives
	- documents
- file details:
	- files properties
		x thumbnail
		- description
		- file information (date, size, etc) (50%)
	- exif information
	- keywords
	- anime/movie
		- title
		- alt title
		- type (anime movie, movie, anime oav, anime tv series, tv series, etc)
		- cover/images
		- genre
		- lang
		- sub lang
		- release date (from - to)
		- anidb link/imdb link
- adding images (60% done)
x generating/saving thumbnails
x moving hardcoded files extensions into config

Legend: [-] not done, [x] done.

For version 2.0:
- Icon grid in files view
- command line support: query, adding media to collection etc
- internationalization support
- statistics

NOTES
=====

Catalog file is tared and optionaly compressed sqlite database and directory
with thumbnails. If there are more images, the size of catalog file will grow.
So be carefull with adding big images in your catalog file!

BUGS
====

All bugs please report to Roman 'gryf' Dobosz <roman.dobosz@gmail.com>