A local party music guessing game powered by Spotify playlists.
- Setup — Paste any public Spotify playlist URL, add player names, choose a clip length (5–30s), and hit Start
- Play — A short audio clip plays; everyone guesses the song out loud
- Score — The host picks who got it right (+3 pts for song, +1 pt for album)
- Finish — Final scoreboard with a shareable results image
No login required. Works entirely in the browser.
- Spotify playlist import (Client Credentials, no user auth)
- 30s audio previews via iTunes Search API (Deezer fallback)
- Blurred album art hint system
- Real-time progress bar + countdown during playback
- Replay clip from guessing phase
- Export final scores as PNG
- Mobile-friendly layout
- Next.js 15 App Router
- TypeScript + Tailwind CSS
- shadcn/ui components
- Spotify Web API (Client Credentials)
- iTunes Search API for audio previews
git clone https://github.com/Waynting/spotify-song-guess_web.git
cd spotify-song-guess_web
npm installCreate a .env.local file:
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secretGet credentials at developer.spotify.com — create an app and copy the Client ID and Secret. No redirect URI needed (Client Credentials flow only).
npm run devOpen http://127.0.0.1:8000.
Note: Use
127.0.0.1:8000specifically — Spotify OAuth is configured for this origin.
| Command | Description |
|---|---|
npm run dev |
Start dev server on port 8000 |
npm run build |
Production build |
npm run start |
Start production server |
npm run lint |
Run ESLint |
- Audio previews — Spotify no longer provides preview URLs for most tracks (deprecated Nov 2024). The app falls back to the iTunes Search API to find a matching 30s preview. A small number of tracks may have no preview available.
- Playlists — Use public playlists you created. Spotify editorial playlists (Discover Weekly, etc.) are not supported.
- Scoring — The host is the judge. No automated answer checking — players guess verbally and the host awards points.