lain/mpd.md

<- widgets

Shows MPD status in a textbox.

mpdwidget = 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)   |
| +-------+                                              |
+--------------------------------------------------------+

input table

Variable	Meaning	Type	Default
timeout	Refresh timeout seconds	int	1
password	MPD password	string	""
host	MPD server	string	"127.0.0.1"
port	MPD port	string	"6600"
music_dir	Music directory	string	"~/Music"
settings	User settings	function	empty function

settings can use mpd_now table, which contains the following string values:

• state (possible values: "play", "pause", "stop")
• file
• artist
• title
• album
• date

and can modify notification_preset table, which will be the preset for the naughty notifications. Check here for the list of variables it can contain. Default definition:

notification _preset = {
   title   = "Now playing",
   timeout = 6,
   text    = string.format("%s (%s) - %s\n%s", mpd_now.artist,
             mpd_now.album, mpd_now.date, mpd_now.title)
}

output table

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

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".