====== XMMS plugin ======

This plugin returns information about a currently running XMMS (X Multimedia System) Player. It uses the /tmp/xmms-info file for getting information about the currently palying track etc. You may need a XMMS plugin called 'XMMS Info Pipe' to create this file. Ensure to have xmms-dev installed in order to avoid problems when installing 'XMMS Info Pipe'.

----

===== Functions =====

|xmms(key)|returns value of <key>|

<key> can be any field name from /tmp/xmms-info:

|Title|The title of the current song|
|Status|The status of XMMS (playing, pause, ...)|
|Tunes in playlist|How many entries are in the playlist|
|Currently playing|which playlist-entry is playing|
|uSecPosition|The position of the title in seconds (usefull for bargraphs ;-) )|
|Position|The position of the title in mm:ss|
|uSecTime|The length of the current title in seconds|
|Time|The length of the current title in mm:ss|
|Current bitrate|The current bitrate in bit|
|Samping Frequency|The current samplingfreqency in Hz|
|Channels|The current number of audiochannels|
|File|The full path of the current file|

----

===== Example =====

<code>
Widget MP3 {
    class      'Text'
    expression  xmms('Title')
    prefix     'playing '
    width       40
    align      'L'
    update      1000
}
</code>


----