Create a live Spotify README widget without writing code. SpotiBadge generates customizable dynamic SVG badges for now playing, recently played, top tracks, and top artists.
Get StartedGo to the Spotify Developer Dashboard and create a new App.
In your App settings, add this Redirect URI: https://spotibadge.vercel.app/callback
Copy your Client ID and Client Secret and paste them into the form on the right.
Sign in with Spotify, customize your widget theme, and copy the Markdown code to your GitHub README.
Spotify restricts "Development Mode" apps to specific users. By using your own App credentials, you become the developer, ensuring you never hit a "403 Forbidden" error.
Your Spotify Client ID and Client Secret are never saved in a database. They are securely encrypted and signed directly into your unique widget URL.
Because the URL contains all necessary info (refresh token + credentials), the app is completely stateless. We only use an in-memory cache to speed up track fetching.
Directly integrate with our core endpoints:
/api/now-playing/{id}.svg: Returns the dynamic SVG./redirect/{id}: Redirects to your current Spotify track.This deployment is running in "Self-Service Mode".