Current Version of Plugin:
[1.4]-9/24/2008
---
View Changelog
---

Instructions

What you need to use this plugin
Installation
Upgrading An Existing Installation
How To Use MusicInfo
Privacy Mode

What You Need To Use This Plugin:

First off, you will need to download and install Pidgin 2.0 or higher from the Pidgin website

The following players will work automatically:

• Winamp v5 - Download
• MusikCube v1 (if it doesn't work, make sure the Winamp Emulator Plugin is turned on) - Download
• Any other player that is based on Winamp or includes a Winamp emulation mode

The following players will work with an extra Winamp emulation plugin for the player:

• foobar2000 - Download
  • foo_winamp_spam - Winamp API Emulator Plugin
• iTunes - Download
  • Multi-Plugin for iTunes (You might need to turn on Winamp emulation mode once it's installed)

The last thing you need is, of course, the latest version of the plugin from the download page on this site.

Installation

1. Copy the file musicinfo.dll that you downloaded into the Pidgin plugins folder.
   This is usually located at C:\Program Files\Pidgin\plugins
2. Start Pidgin, if it's not already started, and open the plugins dialog by choosing Tools->Plugins as shown:
   
3. Find MusicInfo in the list and click the checkbox next to it:
   
4. Click Close on the dialog box and then restart Pidgin
5. MusicInfo is now installed. Keep reading these instructions to find out how to use it.

Upgrading an Existing Installation

If you already have a working installation of MusicInfo and want to upgrade to a newer version of the plugin, download the newer version, close Pidgin, and copy the new musicinfo.dll over the old one. When you start up Pidgin again, it will be upgraded to the latest version.

How to Use MusicInfo

MusicInfo supports customizing the away message, available message, and user info/profile with information about whatever song is currently playing.

Keywords/Tags:

You can use the following keywords to display information about what song you are listening to:

%so% will be replaced by the song name
%ar% will be replaced by the artist name
Use the tags (mi) and (/mi) to mark text that you only want to be displayed when listening to a song. Use the tags (ns) and (/ns) to mark text that you only want to be displayed when not listening to a song.

Examples:

If you put the following text in your profile...

Hi there!
(mi)I am listening to %so% by %ar%(/mi)(ns)I am not listening to music at the moment(/ns)

When you are listening to a song, this will be displayed:

Hi there!
I am listening to Song by Artist

When you are not listening to a song, this will be displayed:

Hi there!
I am not listening to music at the moment

Here's an example with screen shots:
I set this in my away message:

This shows up when I'm listening to music:

And this shows up when I'm not listening to music:

Tips

• Don't forget the closing (/mi) or (/ns) tag! It won't work if you forgot to close it!
• To test whether it's working, add yourself to your buddy list and view your own info
• It only updates every 15 seconds, so if it doesn't work right away, wait a few seconds and check again.

Privacy Mode

MusicInfo includes a Privacy Mode that tells the plugin not to display the music you are listening to. To turn it on and off go to Tools->MusicInfo->Toggle Privacy Mode as shown:

Enjoy the plugin!