Griffith 0.9.2 README
=====================

This document was last updated on Thu Jan 09 2007.
Please see the file COPYING for licensing and warranty information.
The latest version of this software is available at the following URL:
http://griffith.berlios.de/


Table of Contents
=================

* Introduction
* System Requirements
* Installation
* Reporting Bugs
* TODO list
* About the Authors


Introduction
============

Griffith is a film collection manager, released under the GNU/GPL License.


System Requirements
===================

  Name			Minimum version		URL
  ----			---------------		---
  * Python		2.3 or higher		http://www.python.org/
  * GTK+		tested on 2.6.4		http://www.gtk.org/
  * PyGTK (with glade2)	tested on 2.6.1		http://www.pygtk.org/
  * SQLAlchemy		0.3.0			http://www.sqlalchemy.org/
  * pysqlite2		2			http://initd.org/tracker/pysqlite
  * PIL						http://www.pythonware.com/products/pil/
  * PyXML					http://pyxml.sf.net/
  * ReportLab		1.19			http://www.reportlab.org
	
  Other dependencies (optional):
  ------------------------------
  PostgreSQL support:
  * Psycopg2		2			http://initd.org/tracker/psycopg/wiki/PsycopgTwo
  MySQL support:
  * MySQLDb					http://sourceforge.net/projects/mysql-python
  Upgrading from Griffith <=0.6.2 (only if pysqlite 1.0 was used before, 1.1 is not needed)
  * pysqlite		1.0 			http://initd.org/tracker/pysqlite
  Encoding detection of imported CSV file support:
  * chardet					http://chardet.feedparser.org/
  Gtkspell:
  * python-gnome-extras
  Covers and reports support:
  * PDF reader

To check dependencies:
----------------------
  $ ./griffith --check-dep

To show detected Python modules version:
----------------------------------------
  $ ./griffith --show-dep

Windows installer includes all the needed requirements.
A GTK+ runtime is not necessary when using this installer.


External databases
==================

You need to prepare a new database and a new user by yourself

  PostgreSQL
  ----------
	CREATE USER griffith UNENCRYPTED PASSWORD 'gRiFiTh' NOCREATEDB NOCREATEUSER;
	CREATE DATABASE griffith WITH OWNER = griffith ENCODING = 'UNICODE';
	GRANT ALL ON DATABASE griffith TO griffith;

  MySQL
  -----
	CREATE DATABASE `griffith` DEFAULT CHARACTER SET utf8;
	CREATE USER 'griffith'@'localhost' IDENTIFIED BY 'gRiFiTh';
	CREATE USER 'griffith'@'%' IDENTIFIED BY 'gRiFiTh';
	GRANT ALL ON `griffith` . * TO 'griffith'@'localhost';
	GRANT ALL ON `griffith` . * TO 'griffith'@'%';


Installation
============

See INSTALL file


Reporting Bugs                                        
==============
	
If you want to help or report any bugs founded please visit:
  http://griffith.berlios.de/
or
  http://developer.berlios.de/bugs/?group_id=4891


TODO
====

See TODO file


About the Authors
=================

See AUTHORS file
