lain/mpd.md

<- widgets

Shows MPD status in a textbox.

mympd = lain.widgets.mpd()

Now playing songs are notified like this:

+--------------------------------------------------------+
| +-------+                                              |
| |/^\_/^\| Now playing                                  |
| |\ O O /| Cannibal Corpse (Hammer Smashed Face) - 1993 |
| | '.o.' | Hammer Smashed Face (Radio Disney Version)   |
| +-------+                                              |
+--------------------------------------------------------+

Dependencies

• imagemagick

The function takes a table as optional argument, which can contain:

Variable	Meaning	Type	Default
password	MPD password	string	""
host	MPD server	string	"127.0.0.1"
port	MPD port	string	"6600"
music_dir	Music directory	string	"~/Music"
refresh_timeout	Refresh timeout seconds	int	1
header	Text before values	string	""
artist_color	Artist value color	string	beautiful.fg_normal or "#FFFFFF"
song_color	Song value color	string	beautiful.fg_focus or "#FFFFFF"
spr	Separator text between artist and song values	string	" "
footer	Text to append after values	string	""
app	Music program to spawn on click	string	"ncmpcpp"
shadow	Hide widget when there are no songs playing	boolean	false

Note: spr and footer can be markup text.

lain.widgets.mpd outputs the following table:

Variable	Meaning	Type
widget	The textbox	wibox.widget.textbox
notify	The notification	function

Finally, you can control the widget with key bindings like these:

-- MPD control
awful.key({ altkey, "Control" }, "Up",
    function ()
        awful.util.spawn_with_shell("mpc toggle || ncmpcpp toggle || ncmpc toggle || pms toggle")
        mpdwidget.notify()
    end),
awful.key({ altkey, "Control" }, "Down",
    function ()
        awful.util.spawn_with_shell("mpc stop || ncmpcpp stop || ncmpc stop || pms stop")
        mpdwidget.notify()
    end),
awful.key({ altkey, "Control" }, "Left",
    function ()
        awful.util.spawn_with_shell("mpc prev || ncmpcpp prev || ncmpc prev || pms prev")
        mpdwidget.notify()
    end),
awful.key({ altkey, "Control" }, "Right",
    function ()
        awful.util.spawn_with_shell("mpc next || ncmpcpp next || ncmpc next || pms next")
        mpdwidget.notify()
    end),

where altkey = "Mod1".