Skip to content

ElliotJLT/spotifyunwrapped

Repository files navigation

🎧 spotifyunwrapped

Your Spotify data, visualised properly. Privacy-first listening analytics that run entirely in your browser.

TypeScript React Vite License: MIT

What

Spotify Wrapped gives you a 60-second slideshow once a year. This gives you the full picture — any time, with your complete listening history. Upload your Spotify data export and get deep analytics: forgotten favourites, obsession phases, late-night music taste, session patterns, and more. All processing happens client-side. Your data never leaves your device.

Quick Start

git clone https://github.com/ElliotJLT/spotifyunwrapped.git
cd spotifyunwrapped
npm install
npm run dev

Then request your data from Spotify Privacy Settings (select "Extended streaming history"). Upload the JSON files when they arrive.

Features

  • 📈 Listening Timeline — daily activity over your entire history
  • 🎵 Music Eras — how your top artists evolved year by year
  • 💔 Forgotten Favourites — artists you loved but haven't played in 12+ months
  • 🔥 Obsession Phases — weeks where one artist dominated 30%+ of your plays
  • 🌙 Late Night Confessions — what you listen to at 2am vs 2pm
  • ⏭️ Session Insights — duration, frequency, skip rates, shuffle vs intentional
  • 📥 Export — download your dashboard as PDF or PNG

Tech

React, TypeScript, Vite, Tailwind CSS, shadcn/ui, Recharts.

License

MIT

About

Your Spotify data, visualised properly. Privacy-first listening analytics that run entirely in your browser.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages