[<- widgets](https://github.com/copycat-killer/lain/wiki/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) | | +-------+ | +--------------------------------------------------------+ You need a file like this (Front|front|Cover|cover|Art|art|Folder|folder)\.(jpg|jpeg|png|gif) in the album folder in order to show album art too. **Note:** if MPD is turned off or not set correctly, the widget will constantly display "N/A N/A". ### input table Variable | Meaning | Type | Default --- | --- | --- | --- `timeout` | Refresh timeout seconds | int | 2 `password` | MPD password | string | "" `host` | MPD server | string | "127.0.0.1" `port` | MPD port | string | "6600" `music_dir` | Music directory | string | "~/Music" `cover_size` | Album art notification size | int | 100 `default_art` | Default art | string | "" `followmouse` | Notification behaviour | boolean | false `echo_cmd` | custom call for `echo`* | string | "echo" `settings` | User settings | function | empty function \* `echo` implementation is shell dependent, you may need to set this variable properly (`echo -e` [for instance](https://github.com/copycat-killer/lain/issues/112)) in order for the widget to fetch the data correctly. Pay attention to case sensitivity when defining `music_dir`. `settings` can use `mpd_now` table, which contains the following string values: - state (possible values: "play", "pause", "stop") - file - artist - title - album - date - [time](https://github.com/copycat-killer/lain/pull/90) - [elapsed](https://github.com/copycat-killer/lain/pull/90) (seconds) and can modify `mpd_notification_preset` table, which will be the preset for the naughty notifications. Check [here](http://awesome.naquadah.org/doc/api/modules/naughty.html#notify) for the list of variables it can contain. Default definition: mpd_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) } In multiple screen setups, the default behaviour is to show a visual notification pop-up window on the first screen. By setting `followmouse` to `true` it will be shown on the current mouse screen. ### output table Variable | Meaning | Type --- | --- | --- `widget` | The textbox | `wibox.widget.textbox` `update` | 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.update() end), awful.key({ altkey, "Control" }, "Down", function () awful.util.spawn_with_shell("mpc stop || ncmpcpp stop || ncmpc stop || pms stop") mpdwidget.update() end), awful.key({ altkey, "Control" }, "Left", function () awful.util.spawn_with_shell("mpc prev || ncmpcpp prev || ncmpc prev || pms prev") mpdwidget.update() end), awful.key({ altkey, "Control" }, "Right", function () awful.util.spawn_with_shell("mpc next || ncmpcpp next || ncmpc next || pms next") mpdwidget.update() end), where `altkey = "Mod1"`.