1
0
Fork 0
mirror of https://github.com/Zedfrigg/ironbar.git synced 2026-10-04 06:26:16 +02:00
ironbar/docs/modules/MPD.md
2022-11-06 22:52:21 +00:00

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