https://github.com/reymundvirtus/spotify-widget
💻🪟 A translucent Spotify widget with animated visualizers, built in Python (PyQt5).
https://github.com/reymundvirtus/spotify-widget
music-widget productivity pyqt5 python python-widget spotify widget
Last synced: 12 days ago
JSON representation
💻🪟 A translucent Spotify widget with animated visualizers, built in Python (PyQt5).
- Host: GitHub
- URL: https://github.com/reymundvirtus/spotify-widget
- Owner: reymundvirtus
- License: mit
- Created: 2025-06-27T00:07:51.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-07-06T04:27:17.000Z (10 months ago)
- Last Synced: 2025-07-06T05:32:01.557Z (10 months ago)
- Topics: music-widget, productivity, pyqt5, python, python-widget, spotify, widget
- Language: Python
- Homepage:
- Size: 1.02 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎵 Spotify Widget with Lyrics & Visualizer
A frameless, draggable, translucent Spotify widget built with PyQt5.
Displays current track info, album art, and animated visualizer — with Genius lyrics integration (optional).
---
## 🚀 Features
- 🎧 Displays Spotify playback info (title, artist, album art)
- 🎼 Optional: Show lyrics using Genius API
- 🌈 Visualizer animation
- 🪟 Frameless, transparent widget with glass-like style
- 🖱️ Draggable and resizable
---
## ⚙️ Prerequisites
- Python 3.9+
- A Spotify Developer account and app (for access token)
- (Optional) Genius API account (for lyrics)
---
## Step 1: Create `.env`
Create a file named `.env` in the project root and add your credentials:
```env
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback
GENIUS_ACCESS_TOKEN=your_genius_token # Optional, for lyrics
```
---
## Step 2: Install Dependencies
```
python -m venv env
source env/bin/activate # On Windows: env\Scripts\activate
```
Then install the required libraries:
```
pip install -r requirements.txt
```
---
## Step 3: Run the Widget
```
python main.py
```