1
0
Fork 0
mirror of https://github.com/Zedfrigg/ironbar.git synced 2025-04-20 11:54:23 +02:00
ironbar/docs/modules/MPD.md

4.9 KiB

Displays currently playing song from MPD. Clicking on the widget opens a popout displaying info about the current song, album art and playback controls.

Screenshot showing MPD widget with track playing with popout open

Configuration

Type: mpd

Type Default Description
host string localhost:6600 TCP or Unix socket for the MPD server.
format string {icon} {title} / {artist} Format string for the widget. More info below.
icons.play string Icon to show when playing.
icons.pause string Icon to show when paused.
icons.volume string Icon to show under popup volume slider.
music_dir string $HOME/Music Path to MPD server's music directory on disc. Required for album art.
JSON
{
  "start": [
    {
      "type": "mpd",
      "format": "{icon} {title} / {artist}",
      "icons": {
        "play": "",
        "pause": ""
      },
      "music_dir": "/home/jake/Music"
    }
  ]
}
TOML
[[start]]
type = "mpd"
format = "{icon} {title} / {artist}"
music_dir = "/home/jake/Music"

[[start.icons]]
play = ""
pause = ""
YAML
start:
  - type: "mpd"
    format: "{icon} {title} / {artist}"
    icons:
      play: ""
      pause: ""
    music_dir: "/home/jake/Music"
Corn
{
  start = [
    {
      type = "mpd"
      format = "{icon} {title} / {artist}"
      icons.play = ""
      icons.pause = ""
      music_dir = "/home/jake/Music"
    }
  ]
}

Formatting Tokens

The following tokens can be used in the format config option, and will be replaced with values from the currently playing track:

Token Description
{icon} Either icons.play or icons.pause
{title} Title
{album} Album name
{artist} Artist name
{date} Release date
{track} Track number
{disc} Disc number
{genre} Genre
{duration} Duration in mm:ss
{elapsed} Time elapsed in mm:ss

Styling

Selector Description
#mpd Tray widget button
#popup-mpd Popup box
#popup-mpd #album-art Album art image inside popup box
#popup-mpd #title Track title container inside popup box
#popup-mpd #title .icon Track title icon label inside popup box
#popup-mpd #title .label Track title label inside popup box
#popup-mpd #album Track album container inside popup box
#popup-mpd #album .icon Track album icon label inside popup box
#popup-mpd #album .label Track album label inside popup box
#popup-mpd #artist Track artist container inside popup box
#popup-mpd #artist .icon Track artist icon label inside popup box
#popup-mpd #artist .label Track artist label inside popup box
#popup-mpd #controls Controls container inside popup box
#popup-mpd #controls #btn-prev Previous button inside popup box
#popup-mpd #controls #btn-play-pause Play/pause button inside popup box
#popup-mpd #controls #btn-next Next button inside popup box
#popup-mpd #volume Volume container inside popup box
#popup-mpd #volume #slider Volume slider popup box
#popup-mpd #volume .icon Volume icon label inside popup box