Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

Tree [dbdb36] perl-gtk2-crash-compromise / trunk /
History



File Date Author Commit
COPYING 2009-01-08 linleno linleno [dee2e4]
ChangeLog 2009-10-05 Chih-Chun Lin Chih-Chun Lin [b6f63f] commit test
README 2009-10-05 Chih-Chun Lin Chih-Chun Lin [e48d54] Release v.0.2.1
yulastfm.pl 2009-10-05 Chih-Chun Lin Chih-Chun Lin [112dfe] Make YuLastfm conform with the changed XMLNode ...

Read Me

 ABOUT YuLastfm
================
This is a Perl plugin for Pidgin. YuLastfm fetches current track information from
Last.fm through its API. Then, YuLastfm use this fetched infomation to update
Pidgin's TUNE status, also known as Now Playing information, periodically.

 REQUIREMENT
=============

    * Pidgin 2.6.0 or later

 INSTALL
=========

    * For Linux user:
      Simply copy yulastfm.pl to ~/.purple/plugins/
      You can achieve that by giving the following commands.

      $ mkdir -p ~/.purple/plugins
      $ cp yulastfm.pl ~/.purple/plugins

    * For Windows user:
      Before you can use this plugin, you have to install ActivePerl.
      You may visit the pidgin wiki for more information about that.

      http://developer.pidgin.im/wiki/Scripting%20and%20Plugins
      At section "Why doesn't my Perl plugin show up in the Plugins dialog?"

      You could download ActivePerl here.

      http://www.activestate.com/Products/activeperl

      After you make sure you have installed ActivePerl, you have to copy
      yulastfm.pl to one of the following directory.

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

      or

      C:\Program Files\Pidgin\plugins

 CONFIGURATION
===============

    * 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

      Ctrl+U

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

      "Configure Plugin"

      button.

    * There are only two preferences you need to setup,"Last.fm User" and "Refreshing Rate (per sec.)."
    * "Last.fm User" is the Last.fm 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 Last.fm website to regard this as a hostile attack.

 USER INITIATIVE REFRESH
=========================

    * 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 Last.fm "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.

 MORE INFORMATION
==================

    * Project Homepage

      https://sourceforge.net/projects/yulastfm

    * Bug Report and Discussion

      Open Discussion (need to have a SourceForge.net account to post):
      https://sourceforge.net/forum/forum.php?forum_id=904828

      Help Forum (allow anonymous post):
      https://sourceforge.net/forum/forum.php?forum_id=904829

 AUTHOR
========

     * Lin, Chih-Chun <linleno@users.sourceforge.net>