Tree [cedfc8] v0.3.0 / trunk /

File Date Author Commit
COPYING 2009-01-08 linleno linleno [dee2e4]
ChangeLog 2009-03-09 linleno linleno [e3d0f5] v.0.3.0 changlog
README 2009-03-09 linleno linleno [37714b] windows installation instructions
no_artwork.png 2009-03-09 linleno linleno [f57dc8] If there's no artwork found, use this default one. 2009-03-09 linleno linleno [151637] Remove Glib dependence

Read Me

 ABOUT YuLastfm
YuLastfm is a Perl plugin for pidgin. YuLastfm fetches currently playing track information from, and uses this information to update Pidgin's Tune Status, aka Now Playing, periodically.
Since version 0.3.0, YuLastfm provides another interesting function that help you share the
songs' links on to your friends.


    * Pidgin 2.5.4 or later
    * libgtk2-perl


    * For Linux user:
      Copy to ~/.purple/plugins/,
      and then copy no_artwork.png to ~/.purple/yulastfm
      You can achieve this by giving the following commands.

      $ mkdir -p ~/.purple/plugins ~/.purple/yulastfm
      $ cp ~/.purple/plugins
      $ cp no_artwork.png ~/.purple/yulastfm

      Since version 0.3.0, yulastfm also depends on libgtk2-perl package.
      For Ubuntu or Debian users, simply apt-get libgtk2-perl package.

      $ sudo apt-get install libgtk2-perl

      For other distros, please refer to the related distro websites for more

    * For Windows user:  [not have been tested yet in version 0.3.0]
      Before you can use this plugin, you have to install ActivePerl.
      You may visit the pidgin wiki for more information about that.

      At section "Why doesn't my Perl plugin show up in the Plugins dialog?"

      You could download ActivePerl here.

      You also need to install Gtk2-perl package to make YuLastfm work.
      Refer to official Gtk2-perl website for more information.

      After you make sure you have installed ActivePerl and gtk2-perl, you have
      to copy to one of the following directory.

      C:\Documents and Settings\user\Application Data\.purple\plugins


      C:\Program Files\Pidgin\plugins

      And copy no_artwork.png to the directory

      C:\Documents and Settings\user\Application Data\.purple\yulastfm


    * Before do further configuration, you should install this plugin first.
    * Open pidgin, then you can find it in Plugins List by the following menu path

      Tools -> Plugins

      or using the hotkeys


    * After find out YuLastfm on the Plugins List, you can configure it through click on the

      "Configure Plugin"


    * There are only two preferences you need to setup," User" and "Refreshing Rate (per sec.)."
    * " User" is the user account you want to fetch now playing information.
      You don't need the password to make it work.
    * "Refresh Rate (per sec.)" is the time period between each refresh action.
      Generally, the default value, 60, is a reasonable refresh rate.
      Be aware not to set this value too small to let website to regard this as a hostile attack.


    * You can find this action through the following menu path:

      Tools->YuLastfm->"Refresh Tune"

    * The occasion you would like to use it is:

      1. You want to refresh the information from "Right Away."

      2. You just change the Refresh Rate of YuLastfm from the Plugins List, and want the newly setted
         value active right away. If you don't do this, the new Refresh Rate will not replace the old
         one untill the next plugin reload or Pidgin restart.

 SLASH COMMAND /yulastfm

    * In an IM conversation, you can share the songs' links on to your friend by using
      slash command /yulastfm. After you key-in slash command /yulastfm in your conversation box,
      a Gtk2 widget will pop up, and then you could click the track which you would like to share
      with your friend. YuLastfm will send the link to your friend.


    * Project Homepage

    * Bug Report and Discussion

      Open Discussion (need to have a account to post):

      Help Forum (allow anonymous post):


     * Lin, Chih-Chun <>