A web application for analyzing and visualizing your Spotify playback history data.

• Loading and analyzing Spotify playback history data
• Overview statistics including total tracks played, total listening time, unique artists, and unique tracks
• Top artists and top tracks rankings
• Monthly and hourly playback time graphs
• Filtering by date range

• Next.js - React framework (App Router)
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework
• Recharts - React-based charting library
• date-fns - Date manipulation library
• Biome - Linter & formatter

1. Clone the repository

   git clone <repository-url>
   cd spotify-history-analyzer

2. Install dependencies

   npm install

3. Start the development server

   npm run dev

4. Access the application in your browser at http://localhost:3000

This application uses extended playback history data downloaded from Spotify. The data should be in JSON format as follows:

[
  {
    "ts": "2020-01-01T12:00:00Z",
    "platform": "Android",
    "ms_played": 180000,
    "master_metadata_track_name": "Track Name",
    "master_metadata_album_artist_name": "Artist Name",
    "master_metadata_album_album_name": "Album Name",
    ...
  },
  ...
]

1. Download your extended playback history data from Spotify

   • Log in to Spotify
   • Open the Privacy Settings page
   • Select "Extended streaming history" and deselect other options
   • Click the "Request data" button
   • You'll receive an email with your data within 30 days
   • Download my_spotify_data.zip using the instructions in the email

2. Start the application

   npm run dev

3. Access the application in your browser at http://localhost:3000

4. Upload the downloaded ZIP file (my_spotify_data.zip)

   • The file is processed in the browser and is not uploaded to any server
   • Once processing is complete, you'll be automatically redirected to the dashboard page

5. Analyze your data on the dashboard

   • Filter by date range
   • View your top artists and top tracks
   • Check your monthly and hourly listening patterns
   • See platform usage statistics

MIT