GTK-Imonc - GTK+ based imond client for Linux
=============================================

Please have a look at http://www.fli4l.de to get informations about
"imond" and "fli4l".

Download
========

You can grab the newest copies of GTK-Imonc always on
http://userpage.fu-berlin.de/~zeank/gtk-imonc/

Requirements 
============ 

To compile the package you must have GTK+ v2.0 (http://www.gtk.org)
installed on your system (incl. all dependencies).

Notice: If available you must install the development packages
too. For a SuSE 8.2 System these are called:

	* pkgconfig
	* gtk2-devel
	* glib2-devel
	* pango-devel
	* atk-devel
	
Installation of RPM package
===========================

    * $ su
   	* $ rpm -Uvh gtk-imonc-<version>.rpm 

Installation from source tarball
================================

    * Untar the package (tar xfvz <filename>)

    * Change to new directory (cd gtk-imonc-<version>)

    * Invoke:
      
          * $ ./configure
          * $ make

    * As Root (su):
      
          * $ make install

		* By default the program is installed in
		  /usr/local/bin/gtk-imonc. To change this behaviour you can call
		  ./configure with different options. You can get an overview by
		  calling "./configure --help".

    * If you got "/usr/local/bin" in your PATH (echo $PATH) gtk-imonc
      can be started by calling

      $ gtk-imonc <hostname> [port]

			Otherwise you will have to supply the complete path to the
			program.

Options
=======

NOTE: Since version 0.5 no options are required any more! You'll be
presented a preferences dialog if necessary (there's an entry in the
right-click-context-menu if you want to change options). Your settings
will be stored in ~/.imoncrc. Using commandline options you're able to
overwrite your settings there.

To get a list of command-line options call "gtk-imonc -h"
options:
  -n            don't display news panel
  -t [command]  use call notification 
                [command] can be a custom command which is executed
                on incoming call instead of doing a message pop-up
	-i            use systemtray icon								
  -m            start in minimode
  -p pass       use pass as password
  -h            print this help message
  -v            show version and exit

Some words about the "-t" option:
[command] can be a custom command which is called if a new call arrives. 
Information about the incoming call is passed via the following
environment variables:
	* TELMOND_CALL_DATE
	* TELMOND_CALLER
	* TELMOND_CALLEE

See telmond.sh for an example how to use this option.

If [command] is ommitted a pop-up window appears showing the call
informations.

Some Hints on Usage
===================

* right click shows context menu where you can switch to mini-view
  (amongst others)

* store your telephone number mappings in /etc/phonebook or ~/phonebook
  both will be read (in this order) on startup and numbers will be
  replaced by the names given in these files

* "Admin Mode" button is only activ if you have set IMOND_ADMIN_PASS
  in your base.txt (have a look at the FLI4L docs for this)

* for remote update you have to point the source dir to your new
  created configuration
  normall this is done by executing "sh mktgz.sh" in the fli4l base
  directory (the new installation can be found in the "img" subdir)


Disclaimer
==========

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.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA