annotate README @ 6:76f3cd9915c5

branch merge

pidgin-audacious-2.0.0

1. What's this?

pidgin-audacious is a pidgin plugin which updates status and userinfo
message for your pidgin accounts, reflecting the current track name what
you are listening in Audacious.

Moreover, from version 1.1.0, pidgin-audacious can alter your alias
(aka friendly name or nickname) in msn protocol using the current
track name.

This plugin requires pidgin 2.0.0 or later and development version of
audacious (which capable of DBus connection expected to be released
as 1.4.0.).

2. How to build

Building pidgin-audacious plugin is very simple. Please do

./configure
make
make install

If you would like to test new alias substitution feature, please apply
included patch against the pidgin source. 

3. Usage

This plugin expands the token "%song" in your status/userinfo message
and alias with the name of the currently playing music. To show the
track name, you have to compose a message containing the token. The
text format used in audacious playlist will be applied for
substitution.

You can enable or disable expansion in status message, userinfo or
alias respectively. The preferences dialog is available from plugins
window in pidgin.

4. Acknowledgment

This plugin has been built based on Jon Oberheide's
gaim-rhythmbox-2.0beta2. I greatly appreciate his work.


Yoshiki Yazawa
[e-mail]