media

Now-playing title and playback controls for the active MPRIS player.

Add it to your layout with media:

bar:
  layout:
    - monitor: "*"
      right: [media]

General

Field	Type	Default	Description
icon-type	MediaIconType	"application-mapped"	Icon display mode.
player-icons	map of string	{}	Custom player-to-icon mappings for application-mapped mode.
players-ignored	array of string	[]	Player bus name patterns to exclude from discovery. Requires a restart to take effect.
player-priority	array of string	[]	Preferred player priority order as glob patterns matching bus names.
format	string	"{{ title }} - {{ artist }}"	Format string for the label.
icon-name	string	"ld-music-symbolic"	Symbolic icon name for default mode.
spinning-disc-icon	string	"ld-disc-3-symbolic"	Icon shown for spinning-disc mode.
border-show	bool	false	Display border around button.
icon-show	bool	true	Display module icon.
label-show	bool	true	Display text label.
label-max-length	u32	35	Max label characters before truncation with ellipsis. Set to 0 to disable.

More about player-icons

Keys are glob patterns matching MPRIS bus names, values are icon names from the installed icon set. These override built-in mappings when matched.

Example

modules:
  media:
    player-icons:
      "*spotify*": si-spotify-symbolic
      "*firefox*": ld-globe-symbolic
      "*.mpv": ld-play-circle-symbolic

More about players-ignored

Example

modules:
  media:
    players-ignored: ["*chromium*", "*discord*"]

More about player-priority

When no player is manually selected, this determines which player becomes active. Patterns are checked in order; first match wins. If no pattern matches, the first playing player is selected.

Example

modules:
  media:
    player-priority: ["*spotify*", "*firefox*"]

More about format

Placeholders

• {{ title }} - Track title
• {{ artist }} - Artist name(s)
• {{ album }} - Album name
• {{ status }} - Playback status text (Playing, Paused, Stopped)
• {{ status_icon }} - Playback status icon character

Examples

• "{{ title }} - {{ artist }}" - "Bohemian Rhapsody - Queen"
• "{{ status_icon }} {{ title }}" - "▶ Bohemian Rhapsody"
• "{{ artist }}: {{ title }} ({{ album }})" - "Queen: Bohemian Rhapsody (A Night at the Opera)"

Colors

Field	Type	Default	Description
border-color	ColorValue	"blue"	Border color token.
icon-color	ColorValue	"auto"	Icon foreground color. Auto selects based on variant for contrast.
icon-bg-color	ColorValue	"blue"	Icon container background color token.
label-color	ColorValue	"fg-default"	Label text color token.
button-bg-color	ColorValue	"bg-surface-elevated"	Button background color token.

Click actions

Field	Type	Default	Description
left-click	ClickAction	"dropdown:media"	Action on left click.
right-click	ClickAction	""	Action on right click.
middle-click	ClickAction	""	Action on middle click.
scroll-up	ClickAction	""	Action on scroll up.
scroll-down	ClickAction	""	Action on scroll down.

Default configuration

modules:
  media:
    icon-type: application-mapped
    player-icons: {}
    players-ignored: []
    player-priority: []
    format: '{{ title }} - {{ artist }}'
    icon-name: ld-music-symbolic
    spinning-disc-icon: ld-disc-3-symbolic
    border-show: false
    border-color: blue
    icon-show: true
    icon-color: auto
    icon-bg-color: blue
    label-show: true
    label-color: fg-default
    label-max-length: 35
    button-bg-color: bg-surface-elevated
    left-click: dropdown:media
    right-click: ""
    middle-click: ""
    scroll-up: ""
    scroll-down: ""