A Spotify overlay widget for KDE/Linux
Project description
Spotify Overlay
A minimal, always-on-top Spotify overlay for Linux.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file spotify_overlay-1.0.8.tar.gz.
File metadata
- Download URL: spotify_overlay-1.0.8.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
88586001217d081238f4bbf0b43c40e9ab3478295cf01f2e31dac95c4d6187d4
|
|
| MD5 |
7f6307f6e8a74fa4ace5eab099ae627f
|
|
| BLAKE2b-256 |
2d3a92130cb6b00ce1ac281e615787d5c15042bbf1c9eae4e26dd293d1b1b187
|
File details
Details for the file spotify_overlay-1.0.8-py3-none-any.whl.
File metadata
- Download URL: spotify_overlay-1.0.8-py3-none-any.whl
- Upload date:
- Size: 17.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
015f02156b5364fe2bbd09c130d5e6858994479512bf5493fe68f64288c3c276
|
|
| MD5 |
d58d72b6ec5e4106cdf05d88b63c5cad
|
|
| BLAKE2b-256 |
037bb880d92e2071e027fa376611d4286cf8c98010a89c6a7417746b7e45b21b
|
