README for xcallerid-2.1.x
------------------------
xcallerid is a caller ID program for linux.


REQUIREMENTS
------------
1. caller ID capable modem
2. mSQL 2.0 (http://www.hughes.com.au)
	OR
2. mysql
3. gtk+ (>=1.1.14), gtk-- (>=0.11.1)


INSTALLATION
------------
For the default installation,

	./configure
	make

If you want to change any of the defaults, 

	./configure --with-OPTION=VALUE

For a list of options,
	
	./configure --help

To use mysql, try
	
	./configure --with-dbase=mysql	

Before running the app, you need to set up the database.

If you're using mSQL, make sure msql2d is running, then

	cd /usr/local/Hughes/bin; msqladmin create xcallerid

If you're using mysql, the program creates the database for you.

If you've used a previous version of xcallerid, there is no need to
download the wav files again.  Simple move them to 

	/usr/local/share/wav

This should save some bandwidth.

If you're a first time user, download xcallerid_waves.tgz and 
untar/gzip it in the same place you untar/gzipped 
xcallerid-2.1.x.tgz.


RUNNING
-------
First, make sure msql2d is running:

	/usr/local/Hughes/bin/msql2d &

If using mysql:

	/usr/local/mysql/bin/safe_mysqld &

As of v2.0.0, just run the xcallerid executable.

	/usr/local/xcallerid-2.1.?/xcallerid &

The monitoring of the modem can be started and stopped at will,
using the Daemon pulldown menu.

To search the database, use the search menu.  You can search by
number, name, or date (dd-mmm-yyyy, i.e. 26-Jun-1998).  xcallerid
will the list all matching calls.

To update a call (and all the calls with the same number), select a 
call from the list and use the update menu.

If you choose name, you will be given a dialog box to type the new 
name in.  If you choose greeting, you will be given a file selection
dialog to choose a wav file from.


LICENSE
-------
This program is distributed under the GPL.  See the file COPYING
for details.


CONTACT
-------
Copyright (c) 1998 Joe Yandle <yandle@cs.unc.edu>

xcallerid homepage:	

	http://www.cs.unc.edu/~yandle/xcallerid/

	
