Requires:
------------------------------------------------------------------------
    *****
    In order for rating to work, you need to patch Rhythmbox.
    See docs/README.RB-patch
    *****

    - Psi sensors <http://gdesklets.gnomedesktop.org/categories.php?func=gd_show_app&gd_app_id=38>
    - gnome-python <http://ftp.gnome.org/pub/GNOME/sources/gnome-python/>
    - SOAPpy <http://pywebsvcs.sourceforge.net/>
    - Python Imaging Library <www.pythonware.com/products/pil/index.htm>
    - Rhythmbox 0.8.x + included patch for rating to work (see README.RB-patch)


KNOWN ISSUES:
------------------------------------------------------------------------
PROBLEM: Running in a non-UTF8 locale can misrepresent extended ASCII characters.
SOLUTION: Run gdesklets in a UTF8 locale. Instead of running "gdesklets" invoke it as: "env LC_ALL=en_GB.utf8 gdesklets"



Bugs:
------------------------------------------------------------------------
    DEBUG FLAG IS ENABLED BY DEFAULT FOR DEVELOPMENT VERSIONS.
    
    If you find a bug in Rhythmlet, enable the DEBUG flag and file a
    feature request at <http://gdesklets.gnomedesktop.org/categories.php?func=gd_show_app&gd_app_id=162>

    To enable the DEBUG flag open the RLBase.py file
    (usually "~/.gdesklets/Sensors/Rhythmlet/RLBase.py")
    and find the line (line 31 in 0.3g) and change
	_DEBUG = 0
    to:
	_DEBUG = 1

    Restart the display, restart gdesklets from a terminal if necessary
    to see the output, and include this information in your bug report.

    If you're running gDesklets 0.30pre, the debug output will be in:
     ~/.gdesklets/gdesklets<display>.log
     where <display> is the name of the X-display.


Display strings:
------------------------------------------------------------------------
    - %a: artist
    - %A: album
    - %c: Rhythmbox's play count
    - %d: duration (00:00 format)
    - %e: elapsed time (00:00 format)
    - %g: genre
    - %p: file path
    - %r: rating (X/5 format)
    - %s: filesize
    - %t: title
    - %T: track number
    - %N: new line

    examples:
	- %a%N%t
	- %a%N%t  (%e / %d)
	- %a - %t
	- %a - %t  (%e / %d)
	- %a - (%T) %t
	- ... etc.


Icons provided by the Gnome <http://www.gnome.org/> and Rhythmbox <http://www.rhythmbox.org/> projects.
