CupsAndString 0.1 "Initial"

== Features ==
* Non-intrusive listening/logging of all:
 - Telepathy text conversations in other clients
 - Presence updates.
* Interactive:
 - Sending messages in text chats
 - Setting status
 - Requesting roster/presence information.
 - Extension/configuration of the input UI using macros/regexp filters

== Installing ==
Erm... run it from where it is. I'll add a setup.py someday.

== Usage ==
= cupsandstring.pymsn.py
Use cupsandstring.pymsn.py --help for more info. Note that for proper
operation, you need to specify --startup=RC_FILENAME or copy the rc file to
your ~

= cupsandstring.telepathy.py
The recommended usage of cupsandstring.telepathy.py is
cupsandstring.telepathy.py -d [--startup=FILENAME]
This will put it into "Don't connect" mode, so it will listen to anything you
do in another client. You can also inject messages into conversations by
simply typing. Use /who to see who you're talking to. Anything you say will be
said to the first conversation in the list.

= telepathy_listeners.py
This file can be run on its own and it will listen to all conversations
non-interactively. To get free logging functionality, run it like this:
python telepathy_listeners.py | tee -a log.txt
Note that some console control characters are included in the output,
to change the colour of the text, so you might need to do a find/replace
afterwards, if you want to view the log in a text editor. I will implement
a --colour=auto style functionality as soon as I understand how.

== Debugging ==

cupsandstring.telepathy.py relies on some pretty bleeding edge features in
dbus-python and telepathy-python for proper operation. If you get odd behaviour
like repeated notifications, try getting my personal versions of each from
darcs get http://www.srcf.ucam.org/~dl325/voip/telepathy-python
and git clone http://www.srcf.ucam.org/~dl325/voip/dbus-python
and installing them appropriately, until my patchs are included upstream.
You will also need some telepathy connection managers, like butterfly and
gabble.