Metadata-Version: 2.4
Name: spotify-overlay
Version: 1.0.7
Summary: A Spotify overlay widget for KDE/Linux
Author: Lukas
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://github.com/maker-lukas/spotify-overlay
Project-URL: Repository, https://github.com/maker-lukas/spotify-overlay
Project-URL: Issues, https://github.com/maker-lukas/spotify-overlay/issues
Keywords: spotify,overlay,kde,linux,mpris
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: PySide6
Requires-Dist: qasync
Requires-Dist: aiohttp
Requires-Dist: dbus-next

# Spotify Overlay

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

![screenshot](https://raw.githubusercontent.com/maker-lukas/spotify-overlay/main/Screenshot_20260405_153140.png)

### 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

```bash
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:

```bash
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:

```bash
spotify-overlay
```

## Requirements

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

## License

AGPL-3.0
