⚠️ This widget is retired. It has been replaced by the Music widget, which is actively maintained and adds layout options (vertical and square), transport controls, shuffle/repeat, and more. Please use Music instead. This repository is kept for archival purposes only.
A simple music widget for Übersicht. Based on the Playbox widget by Pe8er (now retired). This widget shows the current playing song from either Apple Music or Spotify. It also shows the album artwork if it can find it and has a progress bar with elapsed/remaining time. When a track is loved/favorited in Apple Music, a small star appears next to the title.
There are a few options you can change by editing the index.coffee file.
# Enable or disable the widget.
widgetEnable : true # true | false
# Choose where the widget should sit on your screen.
verticalPosition : "bottom" # top | bottom | center
horizontalPosition : "left" # left | right | center
# Show the time labels next to the progress bar at all. When false the bar
# fills the entire row and showRemainingTime/showBothTimes are ignored.
showTime : true # true | false
# Show time as -M:SS (remaining) instead of M:SS (elapsed).
showRemainingTime : false # true | false
# Show elapsed AND remaining on opposite sides of the bar (overrides the above).
showBothTimes : true # true | false
# Progress bar position.
# "expanded": full-width bar below album art + metadata (default).
# "compact": bar tucked inside the track-info column, beneath the album/year line.
progressBarPosition : "expanded" # expanded | compact- Download the repository and extract it.
- Place the
now-playing.widgetfolder in your Übersicht extension folder. - Refresh Übersicht.
- Apple Music exposes the release year and loved/favorited status; Spotify's scripting API does not, so those are omitted for Spotify tracks.
This widget is theme-aware. Its colors come from CSS custom properties (text, panel tint, status and series colors) with sensible built-in fallbacks, so it looks right on its own. Install the Theme Controller widget and this one automatically follows its color scheme and light/dark mode, staying in sync with the rest of the collection.
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.
