Skip to main content

A Spotify overlay widget for KDE/Linux

Project description

Spotify Overlay

A minimal, always-on-top Spotify overlay for Linux.

screenshot

Demo

Watch the demo video here: https://github.com/user-attachments/assets/e6cf791e-7672-4c7c-9912-8f618322929f

Features

  • Album art, track title, artist, and album name
  • Playback controls (play/pause, next, previous, shuffle, repeat)
  • Progress bar with seek support
  • Always-on-top overlay (KDE Plasma only)
  • Communicates with Spotify via D-Bus (MPRIS)

Install

pip install spotify-overlay
spotify-overlay --install

The --install flag adds Spotify Overlay to your app launcher so you can launch it like a normal app!

Or from source:

git clone https://github.com/maker-lukas/spotify-overlay.git
cd spotify-overlay
pip install .

Usage

Make sure Spotify is running, then launch Spotify Overlay from your application menu like any other app.

You can also run it from the terminal:

spotify-overlay

Requirements

  • Linux with D-Bus
  • Spotify desktop client
  • Python 3.10+
  • KDE Plasma (for always-on-top support)

License

AGPL-3.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spotify_overlay-1.0.9.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

spotify_overlay-1.0.9-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file spotify_overlay-1.0.9.tar.gz.

File metadata

  • Download URL: spotify_overlay-1.0.9.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for spotify_overlay-1.0.9.tar.gz
Algorithm Hash digest
SHA256 c6a473b709968dfbcc31943b76728a53f68ef36e930d9b955e40d2546b7b82ac
MD5 3d133b92f19b5e186d9ae168472a67fa
BLAKE2b-256 9e941fec50efb2760368d8886813e015ed9c4df5778992ec21f4b05f1fa2c449

See more details on using hashes here.

File details

Details for the file spotify_overlay-1.0.9-py3-none-any.whl.

File metadata

File hashes

Hashes for spotify_overlay-1.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 a35cc5420cdf5587f1f492a4ba0e64c908f2808039954c8d6b5a8f7350be9bce
MD5 7a08a3f1d39582a6271aad55787de570
BLAKE2b-256 0b87b26cd1dfb83bb014412a232a308547d5ed5eaf7beb7d382256896379a1ce

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page