nowplaying

Dynamic Last.fm “now playing / last played” card as SVG for your GitHub profile README.

Album art is embedded as base64 inside the SVG so it renders correctly on GitHub (external image URLs inside SVG are blocked in <img> tags).

1. Create a Last.fm API account and copy your API key.
2. Deploy to Vercel (import this repo).
   • Framework preset: Other
   • Build command: leave empty (or use repo vercel.json)
   • Output directory: public (set automatically via vercel.json)
3. Add environment variable: LASTFM_API_KEY = your key.
4. Embed in your profile README (replace domain and username):

![](https://nowplaying-three.vercel.app/api/now-playing?user=KDesp&spin=always&cover=cd)

cp .env.example .env.local   # add LASTFM_API_KEY
npm install
npx vercel dev

Open: http://localhost:3000/api/now-playing?user=YOUR_LASTFM_USER

Alias: cover_style = cover, spin_duration = spin_speed. For spin, true/false map to playing/never.

<!-- Spinning vinyl, always rotates --> 
![](https://nowplaying-three.vercel.app/api/now-playing?user=you&cover=vinyl&spin=always&spin_speed=10)

<!-- CD cover, static when not listening --> 
![](https://nowplaying-three.vercel.app/api/now-playing?user=you&cover=cd&spin=playing)

<!-- Classic square art, no disc --> 
![](https://nowplaying-three.vercel.app/api/now-playing?user=you&cover=square)

<!-- Light theme, wider card --> 
![](https://nowplaying-three.vercel.app/api/now-playing?user=you&theme=light&width=520)

1. user.getRecentTracks (limit 1) — current track or most recent scrobble.
2. Optional track.getInfo when artwork is missing or a placeholder.
3. Album image is fetched server-side and inlined as a data URI in the SVG.
4. Response is cached for 5 minutes (Cache-Control).

MIT