= 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, 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/mpc.shtml mpc].

== 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/mpd-status.py

== Installation and Usage ==
(Instructions are based around the setup for wmii 2 in [http://www.debian.org/ Debian], please add generic instructions where they differ)
  1. Place {{{mpd-status.py}}} somewhere, like {{{/usr/local/bin/}}} or {{{~/.wmii/scripts/}}}.
  1. Copy {{{/etc/wmii/status.sh}}} to {{{~/.wmii/status.sh}}} and edit it, or edit {{{/etc/wmii/status.sh}}} directly.
  1. Edit the following line to include "{{{`python2.4 /path/to/mpc.py`}}}" (see patch attached to this page for an example):
{{{
text="`date` `uptime | sed -e 's/.*://' -e 's/,//g'`"
}}}
  1. Restart wmii: {{{/etc/wmii/rc restart}}}

You should see some extra text on your wmibar, either "--Not playing--" or your currently playing/paused track.

== License ==
{{{mpd-status}}} is free software; you can redistribute it and/or modify it under the terms of version 2 of the [http://www.fsf.org/licensing/licenses/gpl.html 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 [http://www.fsf.org/licensing/licenses/gpl.html GNU General Public License] for more details.