Readme Display

Dynamic widgets to show off your Last.fm and Letterboxd stats in your readme. Inspired by novatorem

Examples

Last.fm - Now Playing

Last.fm - Top Artists

Letterboxd - Recently watched

What?

A Next.js app that generates SVG images to display:

• Your latest (or current) Last.fm scrobbled track
• Your top 5 Last.fm artists for the last 7 days
• Your last 3 Letterboxd diary entries

Why?

Just because!

How?

1. Fork this repo
2. Deploy to Vercel
3. Set up the environment variables:

LASTFM_USERNAME=your-lastfm-username
LASTFM_API_KEY=your-lastfm-api-key
LETTERBOXD_USERNAME=your-letterboxd-username

4. Choose a theme and add it as a query param to the URL. If no theme is provided, the default theme will be used. The available themes are:

• blackmetal
• brutal
• citypop
• darkwave
• gameboy
• glass
• minimal (default)
• neon
• postpunk
• retro
• sunbather
• synthwave
• terminal
• vaporwave
• witchhouse

5. Add the widgets you want to your readme:

![Last.fm](https://your-deployment-url.vercel.app/api/last-fm/now-playing?theme=brutal)
![Last.fm](https://your-deployment-url.vercel.app/api/last-fm/top-artists?theme=darkwave)
![Letterboxd](https://your-deployment-url.vercel.app/api/letterboxd?theme=postpunk)

Development

Install dependencies

bun install

Run locally

bun dev

Run tests

bun test

License

MIT

---

Made with ❤️ by @brrianalexis