waybar - MPRIS module
The mpris module displays currently playing media via libplayerctl.
player:
|
typeof: string | ||
|
default: playerctld | ||
|
Name of the MPRIS player to attach to. Using the default value always follows the currently active player. |
ignored-players:
|
typeof: []string | |
|
Ignore updates of the listed players, when using playerctld. |
interval:
|
typeof: integer | |
|
default: 0 | |
|
Refresh MPRIS information on a timer. |
format:
|
typeof: string | |
|
default: {player} ({status}) {dynamic} | |
|
The text format. |
format-[status]:
|
typeof: string | |
|
The status-specific text format. |
tooltip:
|
typeof: bool | |
|
default: true | |
|
Option to disable tooltip on hover. |
tooltip-format:
|
typeof: string | |
|
default: {player} ({status}) {dynamic} | |
|
The tooltip text format. |
tooltip-format-[status]:
|
typeof: string | |
|
The status-specific tooltip format. |
artist-len:
|
typeof: integer | |
|
Maximum length of the Artist tag (Wide/Fullwidth Unicode characters count as two). Set to zero to hide the artist in ‘{dynamic}‘ tag. |
album-len:
|
typeof: integer | |
|
Maximum length of the Album tag (Wide/Fullwidth Unicode characters count as two). Set to zero to hide the album in ‘{dynamic}‘ tag. |
title-len:
|
typeof: integer | |
|
Maximum length of the Title tag (Wide/Fullwidth Unicode characters count as two). Set to zero to hide the title in ‘{dynamic}‘ tag. |
dynamic-len:
|
typeof: integer | |
|
Maximum length of the Dynamic tag (Wide/Fullwidth Unicode characters | |
|
count as two). The dynamic tag will not truncate any tags beyond their | |
|
set length limits, instead, it will attempt to fit as much of the | |
|
available tags as possible. It is recommended you set title-len to | |
|
something less than or equal to this value, so the title will always be | |
|
displayed. |
dynamic-order:
|
typeof: []string | |
|
default: ["title", "artist", "album", "position", "length"] | |
|
Order of the tags shown by Dynamic tag. The position and length tags | |
|
will always be combined in the format [{position}/{length}]. The order | |
|
of these tags in relation to other tags will be determined based on the | |
|
declaration of the first among the two tags. Absence in this list means | |
|
force exclusion. |
dynamic-importance-order:
|
typeof: []string | |
|
default: ["title", "artist", "album", "position", "length"] | |
|
Priority of the tags when truncating the Dynamic tag. The final ones | |
|
will be the first to be truncated. Absence in this list means force | |
|
inclusion. |
dynamic-separator:
|
typeof: string | |
|
default: " - " | |
|
These characters will be used to separate two different tags, except | |
|
when one of these tags is position and length. |
truncate-hours:
|
typeof: bool | |
|
default: true | |
|
Whether to hide hours when media duration is less than an hour long. |
enable-tooltip-len-limits:
|
typeof: bool | |
|
default: false | |
|
Option to enable the length limits for the tooltip as well. By default, the tooltip ignores all length limits. |
ellipsis:
|
typeof: string | |
|
default: "â¦" | |
|
This character will be used when any of the tags exceed their maximum length. If you don’t want to use an ellipsis, set this to empty string. |
rotate:
|
typeof: integer | |
|
Positive value to rotate the text label (in 90 degree increments). |
max-length:
|
typeof: integer | |
|
The maximum length in character the module should display. |
min-length:
|
typeof: integer | |
|
The minimum length in characters the module should accept. |
align:
|
typeof: float | |
|
The alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. If the module is rotated, it will follow the flow of the text. |
justify:
|
typeof: string | |
|
The alignment of the text within the module’s label, allowing options ’left’, ’right’, or ’center’ to define the positioning. |
on-click:
|
typeof: string | |
|
default: play-pause | |
|
Overwrite default action toggles. |
on-click-middle:
|
typeof: string | |
|
default: previous track | |
|
Overwrite default action toggles. |
on-click-right:
|
typeof: string | |
|
default: next track | |
|
Overwrite default action toggles. |
player-icons:
|
typeof: map[string]string | |
|
Allows setting {player_icon} based on player-name property. |
status-icons:
|
typeof: map[string]string | |
|
Allows setting {status_icon} based on player status (playing, paused, stopped). |
expand:
|
typeof: bool | |
|
default: false | |
|
Enables this module to consume all left over space dynamically. |
{player}: The name of the current media player
{status}: The current status (playing, paused, stopped)
{artist}: The artist of the current track
{album}: The album title of the current track
{title}: The title of the current track
{length}: Length of the track, formatted as HH:MM:SS
{dynamic}: Use {artist}, {album}, {title} and {length}, automatically omit
|
empty values |
{player_icon}: Chooses an icon from player-icons based on {player}
{status_icon}: Chooses an icon from status-icons based on {status}
"mpris": {
|
"format": "{player_icon} {dynamic}", | |||
|
"format-paused": "{status_icon} <i>{dynamic}</i>", | |||
|
"player-icons": { | |||
|
"default": "â¶", | |||
|
"mpv": "ðµ" | |||
|
}, | |||
|
"status-icons": { | |||
|
"paused": "â¸" | |||
|
}, | |||
|
// "ignored-players": ["firefox"] |
}
|
• |
#mpris |
|||
|
• |
#mpris.${status} |
|||
|
• |
#mpris.${player} |