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

<?><?><?> (NAME)
       waybar-mpris - <?><?><?><?><?> MPRIS <?><?> waybar

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> mpris <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?> libplayerctl <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       player:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: playerctld
       <?><?><?> <?><?><?><?><?><?><?><?><?> MPRIS <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?>. <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       ignored-players:
       <?><?><?>: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       ([]string)
       <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> playerctld.

       interval:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?><?>: 0
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> MPRIS <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>.

       format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: {player} ({status}) {dynamic}
       <?><?><?><?> <?><?><?>.

       format-[status]:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>.

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

       tooltip-format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: {player} ({status}) {dynamic}
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

       tooltip-format-[status]:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?>.

       artist-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>). <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> `{dynamic}` <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.

       album-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>). <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> `{dynamic}` <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.

       title-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>). <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> `{dynamic}` <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.

       dynamic-len:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> (Dynamic)
       (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>).
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> title-len <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>
       <?><?><?><?> <?><?><?>.

       dynamic-order:
       <?><?><?>: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       ([]string)
       <?><?><?><?><?><?><?>: ["title", "artist", "album", "position",
       "length"]
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?><?><?><?><?> position <?> length
       <?><?><?><?><?><?> <?><?> <?><?><?><?> [{position}/{length}]
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?>.

       dynamic-importance-order:
       <?><?><?>: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       ([]string)
       <?><?><?><?><?><?><?>: ["title", "artist", "album", "position",
       "length"]
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       dynamic-separator:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: " - "
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> position <?> length <?><?><?><?>.

       truncate-hours:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?>.

       enable-tooltip-len-limits:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       ellipsis:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: "<?>"
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

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

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

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

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

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

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

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

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

       player-icons:
       <?><?><?>: <?><?><?><?><?> (map[string]string)
       <?><?><?><?><?> <?><?><?><?><?> {player_icon} <?><?> <?><?><?><?>
       <?><?><?><?><?> player-name <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       status-icons:
       <?><?><?>: <?><?><?><?><?> (map[string]string)
       <?><?><?><?><?> <?><?><?><?><?> {status_icon} <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (playing<?> paused<?>
       stopped) <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

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

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (FORMAT
       REPLACEMENTS)
       {player}: <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>

       {status}: <?><?><?><?><?> <?><?><?><?><?> (playing<?> paused<?>
       stopped)

       {artist}: <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?>

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

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

       {length}: <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> HH:MM:SS

       {dynamic}: <?><?><?><?><?><?><?> <?><?> {artist}<?> {album}<?> {title}
       <?> {length}<?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>

       {player_icon}: <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       player-icons <?><?> <?><?><?><?> {player}

       {status_icon}: <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       status-icons <?><?> <?><?><?><?> {status}

<?><?><?><?><?><?><?> (EXAMPLES)
           "mpris": {
                "format": "{player_icon} {dynamic}",
                "format-paused": "{status_icon} <i>{dynamic}</i>",
                "player-icons": {
                     "default": "<?>",
                     "mpv": "<?>"
                },
                "status-icons": {
                     "paused": "<?>"
                },
                // "ignored-players": ["firefox"]
           }

<?><?><?><?><?><?> (STYLE)
       o   #mpris
       o   #mpris.${status}
       o   #mpris.${player}

                                  2026-08-31                   waybar-mpris(5)