Skip to content

media

Shows the current media artwork and track title from MPRIS. On vertical bars (left / right), only the artwork is shown. On horizontal bars, enable album_art_only for the same compact look.

Left-click opens the Media tab in the control center; right-click toggles play/pause. The mouse side buttons (back / forward) skip to the previous and next track. Every action targets the active player shown on the widget.

SettingTypeDefaultDescription
album_art_onlyboolfalseShow only circular album artwork (horizontal bars; hidden in Settings on vertical bars)
hide_album_artboolfalseHide the album artwork (horizontal bars). Also hides the fallback icon
hide_artistboolfalseHide the artist and show only the track title (horizontal bars; ignored when album_art_only is enabled)
artist_firstboolfalseShow Artist - Title instead of Title - Artist (horizontal bars; ignored when hide_artist or album_art_only is enabled)
min_lengthnumber80Minimum widget length in pixels (hidden when album_art_only is enabled)
max_lengthnumber220Maximum widget length in pixels (hidden when album_art_only is enabled)
art_sizenumber16Artwork size in pixels before scale
title_scrollstring"none"Media title scrolling mode: "none", "always", or "on_hover" (hidden when album_art_only is enabled)
hide_when_no_mediaboolfalseHide the widget when no MPRIS player is active
[widget.media]
artist_first = true
art_size = 24
hide_when_no_media = true