About DiskSearch
----------------

DiskSearch is a tool for searching for files on all your removable media
disks (e.g. CD's, ZIP disks or backup tapes). For instance you can search
for songs on your MP3-CD's or for a document on your backup DVD's. 
For advanced queries there is a regular expression search mode.
The search is based on a simple database file which needs to be filled
once by adding all your disks to it.

Since version 0.9.0 the projects has been renamed from 'CDSearch' to 
'DiskSearch' because it's possible to archive many types of removable 
media now.


Requirements
------------

DiskSearch is written in Python using the Python bindings for the GTK+ 
toolkit. So you need: 

- Python >= 2.3 (from http://www.python.org)
- GTK+ >= 2.2.0 (from http://www.gtk.org)
- PyGTK >= 2.2.0 (from http://www.pygtk.org)
  (make sure that PyGTK contains libglade support)

DiskSearch is tested on GNU/Linux (Debian Sarge) and Windows XP, although 
it should work on all Unix-like and Win32 systems.


Installation on Linux or other Unix-based systems
-------------------------------------------------

To install DiskSearch extract the archive to some temporary directory and 
run 'make install' as root. This will install DiskSearch to '/usr/local'.
You can also simply uninstall DiskSearch by calling 'make uninstall'.
To start DiskSearch after installation just enter the 'disksearch' command.

The name of the Python interpreter executable can differ on some systems.
If you have problems to start DiskSearch you probably need to edit the 
Python reference in the file 'disksearch'.


Installation on Win32 systems
-----------------------------

First you need to install Win32 version of Python, GTK+ and PyGTK. 
You can download the installers from these locations:

- Python for Win32:         http://www.python.org
- GTK+ runtime for Win32:   http://gladewin32.sourceforge.net
- PyGTK for Win32:          http://www.pcpm.ucl.ac.be/~gustin/win32_ports

Please don't use space characters in the installation directories. I've 
tested DiskSearch with Python 2.3.4, GTK+ 2.4.9 and PyGTK 2.2.0 on Windows
2000 and XP without any problems.

Then extract the DiskSearch archive and you can start it with run-win32.bat.
But it's more comfortable to create a shortcut on the desktop or in your start 
menu.


Command line options
--------------------

Usage: disksearch.py [-a file] [-V] [-h]
-a, --archive file    use specified archive file
-V, --version         show program version
-h, --help            show this usage information


Contact
-------

You can use the forum and the bug system on the Sourceforge project page 
(http://sourceforge.net/projects/disksearch) when you have comments,
suggestions or problems with bugs.
The most recent version of this tool can also be found there. If you're 
interested in the current development version you can get it from CVS.

For direct email contact you can use the address: projects@saring.de 


License
-------

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.


Stefan Saring & Mathias Obst
2004/11/04
