                                GKrellM-Licq
                                ------------


Introduction
------------

GKrellM-Licq is a pair of plugins, one for GKrellM and one for Licq, to monitor
Licq's current status and pending messages/events in GKrellM.


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

The GKrellM plugin requires GKrellM version 2.1.12 or higher. What requirements
there is for Licq version is uncertain. However, the Licq plugin has been
tested to work with version 1.2.6 and 1.2.7.


Installation
------------

To install, try:

./configure && make && su -c "make install"

It will will install the plugins under "/usr/local/lib/licq" and
"/usr/local/lib/gkrellm2/plugins". This should work fine as long as GKrellM and
Licq are installed with the "/usr/local" prefix. If Licq is installed under the
"/usr" prefix, you might want to try this instead:

./configure --prefix=/usr && make && su -c "make install"

It will will install the plugins under "/usr/lib/licq" and
"/usr/lib/gkrellm2/plugins". 

After the plugins have been installed the Licq plugin has to be loaded and
enabled in Licq and the GKrellM plugin has to be enabled in GKrellM.

If not already existing, the Licq plugin will create the directory
"~/.licq/infofs" when run.

!!OBSERVE!!

When loaded while Licq is running, the plugin currently can not determine the
the Licq status or if there are any events pending. This remains true until
the status has changed at least once and at least one event has been received
(the two will start working independently of each other). This could make it
seem as if the plugin is not working at first, while it actually is. When later
(re)starting Licq with the plugin already loaded, this will not be a problem.


GKrellM Theme
-------------

The GKrellM plugin can be themed by placing alternative status and event icons
under a theme directory called "licq".

The status icons are called: "online", "away", "na", "dnd", "occ", "ffc",
"offline" and "invisible".

The events icons are called: "message", "file", "url", "sms" and "chat".

(I have not really tried this feature out, but it is supposed to work.)


Feedback/Contact
----------------

Please direct bug reports and whatever interesting feedback to:

Mattias Eklf
<tias@ludd.ltu.se>

The latest version of GKrellM-Licq can be found at:

http://www.ludd.ltu.se/~tias/gkrellm-licq/