https://github.com/krispowers/spotify-embed
Live Spotify now-playing badge for your GitHub README 🕺🎵
https://github.com/krispowers/spotify-embed
github readme spotify
Last synced: 24 days ago
JSON representation
Live Spotify now-playing badge for your GitHub README 🕺🎵
- Host: GitHub
- URL: https://github.com/krispowers/spotify-embed
- Owner: KrisPowers
- Created: 2026-03-05T22:51:16.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-04T00:38:42.000Z (about 2 months ago)
- Last Synced: 2026-05-04T02:31:14.052Z (about 2 months ago)
- Topics: github, readme, spotify
- Language: TypeScript
- Homepage:
- Size: 54.2 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Spotify README Worker
A single Cloudflare Worker that serves a setup UI and live SVG badges for your GitHub README.
## Preview (Only shows If I am listening to music):
## Widgets
| Badge | Embed URL |
|---|---|
| Now Playing | `https://your-worker.workers.dev/now-playing.svg` |
| Top Artists | `https://your-worker.workers.dev/top-artists.svg?range=short_term&count=8` |
| Top Tracks | `https://your-worker.workers.dev/top-tracks.svg?range=mid_term&count=5` |
**Range options:** `short_term` (4 weeks) · `mid_term` (6 months) · `long_term` (all time)
**Count:** 1–10
## Setup
### 1. Install & login
```bash
npm install
npx wrangler login
```
### 2. Add your Spotify app credentials
Go to [developer.spotify.com/dashboard](https://developer.spotify.com/dashboard), create an app, and add `https://your-worker.workers.dev/callback` as a Redirect URI.
```bash
npx wrangler secret put SPOTIFY_CLIENT_ID
npx wrangler secret put SPOTIFY_CLIENT_SECRET
```
### 3. Deploy
```bash
npx wrangler deploy
```
### 4. Get your refresh token
Visit `https://your-worker.workers.dev/auth`, authorize with Spotify, then follow the on-screen instructions to add `SPOTIFY_REFRESH_TOKEN` and redeploy.
### 5. Visit the setup UI
Go to `https://your-worker.workers.dev` to configure and copy your embed snippets.
## Local development
```bash
npm run dev
# Visit http://localhost:8787
```
Add a `.dev.vars` file for local secrets:
```
SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REFRESH_TOKEN=your_refresh_token
```