waybar-mpd(5)                 File Formats Manual                waybar-mpd(5)

<?><?><?> (NAME)
       waybar-mpd - <?><?><?><?><?> mpd <?><?> waybar

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> mpd <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <<Music Player
       Daemon>> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> <?><?><?> mpd <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       server:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> MPD. <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       port:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?> MPD <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       password:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> MPD. <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> MPD <?><?><?><?><?> <?><?><?><?><?><?><?>.

       interval:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?><?>: 5
       <?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?>) <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> MPD <?><?><?><?><?> <?><?><?><?><?><?>.

       timeout:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?><?>: 30
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?>
       <?><?><?><?><?>). <?><?><?> <?><?><?><?> MPD <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> connection_timeout <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       unknown-tag:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "N/A"
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> format <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "{album} - {artist} - {title}"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?>.

       format-stopped:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "stopped"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.

       format-paused:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> (<?><?><?>) <?><?><?> <?><?><?><?>.

       format-disconnected:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "disconnected"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> MPD <?><?> <?><?><?><?><?>
       <?><?><?><?>.

       tooltip:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?>.

       tooltip-format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "MPD (connected)"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> MPD.

       tooltip-format-disconnected:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "MPD (disconnected)"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> MPD <?><?> <?><?><?><?><?> <?><?><?><?>.

       artist-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (Artist).

       album-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> (Album).

       album-artist-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> (Album Artist).

       title-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> (Title).

       rotate:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?>).

       max-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       min-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       align:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> (float)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?> 0 <?><?><?><?><?><?> <?> 1
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       justify:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> 'left' (<?><?>)<?> 'right'
       (<?><?><?><?>) <?><?> 'center' (<?><?><?>) <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       on-click:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-click-middle:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       (<?><?> <?><?><?> <?><?><?><?>) <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-click-right:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-update:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-scroll-up:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> (<?><?><?><?><?><?>) <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       on-scroll-down:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       smooth-scrolling-threshold:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> (double)
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       state-icons:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?><?>: {}
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?>/<?><?><?> <?><?><?><?><?><?><?><?><?> ({ "playing": "...",
       "paused": "..." }).

       consume-icons:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?><?>: {}
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?>>> (consume) ({ "on": "...", "off": "..." }).

       random-icons:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?><?>: {}
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?>>> (random) ({ "on": "...", "off": "..." }).

       repeat-icons:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?><?>: {}
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?>>> (repeat) ({ "on": "...", "off": "..." }).

       single-icons:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?><?>: {}
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?><?>>> (single) ({ "on": "...", "off": "..." }).

       menu:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       menu-file:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           GtkMenu <?><?> <?><?><?><?><?> menu <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>.

       menu-actions:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>.

       expand:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (FORMAT
       REPLACEMENTS)
   <?><?><?><?><?> <?><?><?>/<?><?><?> (WHEN PLAYING/PAUSED)
       {artist}: <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       {albumArtist}: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       {album}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       {title}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       {date}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       {volume}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?>.

       {elapsedTime}: <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>/<?><?><?><?> (<?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>).

       {totalTime}: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>/<?><?><?><?> (<?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>).

       {songPosition}: <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?>.

       {queueLength}: <?><?><?> <?><?> <?><?><?> <?><?><?><?>.

       {uri}: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (URI)
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> MPD.

       {filename}: <?><?><?> <?><?><?><?><?><?> URI (<?><?><?> <?><?><?><?>).

       {stateIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> (<?><?><?><?><?>
       state-icons <?><?> <?><?><?><?><?><?>).

       {consumeIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <<<?><?><?><?>>> (<?><?><?><?><?> consume-icons <?><?>
       <?><?><?><?><?><?>).

       {randomIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?>>> (<?><?><?><?><?> random-icons <?><?>
       <?><?><?><?><?><?>).

       {repeatIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?>>> (<?><?><?><?><?> repeat-icons <?><?>
       <?><?><?><?><?><?>).

       {singleIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?><?>>> (<?><?><?><?><?> single-icons <?><?>
       <?><?><?><?><?><?>).

   <?><?><?><?><?> <?><?><?><?> (WHEN STOPPED)
       {consumeIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <<<?><?><?><?>>> (<?><?><?><?><?> consume-icons <?><?>
       <?><?><?><?><?><?>).

       {randomIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?>>> (<?><?><?><?><?> random-icons <?><?>
       <?><?><?><?><?><?>).

       {repeatIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?>>> (<?><?><?><?><?> repeat-icons <?><?>
       <?><?><?><?><?><?>).

       {singleIcon}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?><?>>> (<?><?><?><?><?> single-icons <?><?>
       <?><?><?><?><?><?>).

   <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> (WHEN DISCONNECTED)
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "mpd": {
                "format": "{stateIcon} {consumeIcon}{randomIcon}{repeatIcon}{singleIcon}{artist} - {album} - {title} ({elapsedTime:%M:%S}/{totalTime:%M:%S}) <?>",
                "format-disconnected": "Disconnected <?>",
                "format-stopped": "{consumeIcon}{randomIcon}{repeatIcon}{singleIcon}Stopped <?>",
                "interval": 2,
                "consume-icons": {
                     "on": "<?> " // Icon shows only when "consume" is on
                },
                "random-icons": {
                     "off": "<span color="#f53c3c"><?></span> ", // Icon grayed out when "random" is off
                     "on": "<?> "
                },
                "repeat-icons": {
                     "on": "<?> "
                },
                "single-icons": {
                     "on": "<?>1 "
                },
                "state-icons": {
                     "paused": "<?>",
                     "playing": "<?>"
                },
                "tooltip-format": "MPD (connected)",
                "tooltip-format-disconnected": "MPD (disconnected)"
           }

<?><?><?><?><?><?> (STYLE)
       o   #mpd
       o   #mpd.disconnected
       o   #mpd.stopped
       o   #mpd.playing
       o   #mpd.paused

                                  2026-08-31                     waybar-mpd(5)