= MPD Status =

MPD Status is a quick Python script to display some details about the track currently playing in [http://www.musicpd.org/ MPD].  It is intended for use in [http://wmii.de wmii]'s status bar.

If you want a more featureful status bar for wmii, check out [http://wmii.de/index.php/Contrib/Szs3rd szs3rd], from which I shamelessly copied and hacked the `mpc.py` module.

== Features ==
  * Displays currently playing/paused song (that's a given really) with time.
  * If metadata isn't provided, falls back to the basename of the file.

== Requirements ==
  * [http://www.python.org/ Python 2.4].
  * [http://www.musicpd.org/py-libmpdclient.shtml py-libmpdclient].

== Download ==
Checkout [source:mpd-status/trunk/ mpd-status/trunk/] from the [http://subversion.tigris.org/ Subversion] repository:
{{{
svn co http://svn.bleah.co.uk/repos/misc/mpd-status/trunk
}}}
or, since it is just the one file, grab it via HTTP from http://svn.bleah.co.uk/repos/misc/mpd-status/trunk/mpdstatus.py

== Usage ==

When run, the script simply outputs current track information (or volume info) to standard output.  To have this update continuously, run it repeatedly inside a loop construct, for example (using `sh`):
{{{
#!sh
while true
do
    mpdstatus.py
    sleep 1
done
}}}
Some example 'status' rc scripts for wmii 2.5 are contained in the [source:mpd-status/trunk/examples/ examples] directory.

== License ==
`mpd-status` is free software; you can redistribute it and/or modify it under the terms of version 2 of the [/licenses/gpl-2.0 GNU General Public License] as published by the [http://www.fsf.org/ Free Software Foundation].

`mpd-status` is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the [/licenses/gpl-2.0 GNU General Public License] for more details.