The Rolling Stone top 500 albums list with additions from Wikipedia.
Find a file
Johan Lundberg 3cf9d74eae Fix JavaScript to properly handle dropped albums status
- Updated filter logic to recognize "Dropped" status albums
- Fixed statistics counting for dropped albums
- Added proper CSS class and formatting for dropped status
- Updated rank validation to handle extended range (1-523)
- Added dropdown arrow icon (⤵) for dropped albums
- Now properly shows dropped count and filters work correctly

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-01 00:52:49 +02:00
covers Clean up repository by removing unnecessary files 2025-07-01 00:40:00 +02:00
scripts Add dropped albums from 2020 list with historical context 2025-07-01 00:49:07 +02:00
CLAUDE.md Complete Top 500 Albums project with 100% data coverage and UI improvements 2025-07-01 00:33:47 +02:00
favicon.svg Add comprehensive website functionality with enhanced navigation and sharing 2025-06-30 21:51:10 +02:00
index.html Add comprehensive website functionality with enhanced navigation and sharing 2025-06-30 21:51:10 +02:00
README.md Add comprehensive README with project overview and documentation 2025-07-01 00:41:07 +02:00
rolling_stone_top_500_albums_2020.csv init 2025-06-30 20:48:36 +02:00
script.js Fix JavaScript to properly handle dropped albums status 2025-07-01 00:52:49 +02:00
styles.css Complete Top 500 Albums project with 100% data coverage and UI improvements 2025-07-01 00:33:47 +02:00
top_500_albums_2023.csv Add dropped albums from 2020 list with historical context 2025-07-01 00:49:07 +02:00
wikipedia_top_500_albums.csv correct wikipedia list 2025-06-30 23:05:40 +02:00

🎵 Rolling Stone's Top 500 Albums

A beautiful, interactive web application showcasing Rolling Stone's greatest albums of all time with visual comparisons between the 2020 and 2023 rankings.

Top 500 Albums Data Complete Cover Art

Features

  • Interactive Album Cards: Browse all 500 albums with high-quality cover art
  • Ranking Comparisons: See how albums moved between 2020 and 2023 rankings
  • Complete Metadata: Full album information including artist, year, label, and descriptions
  • Responsive Design: Beautiful layout that works on all devices
  • Search & Filter: Easy navigation through the extensive collection

🚀 Live Demo

Open index.html in your browser to explore the collection, or serve it locally:

python -m http.server 8000
# Then visit http://localhost:8000

📊 Data Sources

  • 2020 Rankings: Rolling Stone's original 500 Greatest Albums list
  • 2023 Rankings: Updated rankings from Rolling Stone's revised list
  • Album Information: Comprehensive metadata including release info and descriptions
  • Cover Art: High-quality album artwork sourced from iTunes API

🎨 What's Included

Core Files

  • index.html - Main web application
  • styles.css - Beautiful, responsive styling
  • script.js - Interactive functionality
  • favicon.svg - Custom music note favicon

Data Files

  • top_500_albums_2023.csv - Complete dataset with 100% metadata coverage
  • rolling_stone_top_500_albums_2020.csv - Original 2020 rankings
  • wikipedia_top_500_albums.csv - Wikipedia sourced data for comparison

Assets

  • covers/ - 500 high-quality album cover images (rank_XXX_Artist_Album.jpg)

Utilities

  • scripts/ - Python scripts for data processing and maintenance

🛠️ Scripts

The repository includes various Python utilities for data management:

Script Purpose
compare_top500_albums.py Generate the main comparison dataset
merge_descriptions.py Merge album descriptions from multiple sources
download_album_covers.py Download album artwork from iTunes API
add_missing_info.py Add metadata for albums missing information
fill_missing_from_wikipedia.py Research and add Wikipedia-sourced descriptions

📈 Data Quality

  • 500/500 albums with complete ranking information
  • 500/500 albums with cover art
  • 500/500 albums with metadata (artist, album, year, label)
  • 500/500 albums with descriptions (mix of original Rolling Stone content and researched additions)

🎯 Key Insights

Notable Changes (2020 → 2023)

  • Biggest Climber: Lauryn Hill's "The Miseducation of Lauryn Hill" (#10 in 2023, previously much lower)
  • New Entries: Recent albums like Beyoncé's "Renaissance" and Bad Bunny's "Un Verano Sin Ti"
  • Genre Diversity: Increased representation of hip-hop, R&B, and global music

Statistics

  • Most Represented Artist: The Beatles (multiple albums in top rankings)
  • Decades Covered: 1950s through 2020s
  • Genres: Rock, Hip-Hop, R&B, Soul, Punk, Electronic, Country, Jazz, and more

🔧 Technical Details

Frontend

  • Vanilla JavaScript for maximum compatibility
  • CSS Grid & Flexbox for responsive layouts
  • Progressive Enhancement for accessibility

Data Processing

  • Python 3 scripts for data manipulation
  • CSV format for easy data management
  • iTunes API integration for cover art
  • Fuzzy string matching for data correlation

📝 Development

Running Locally

  1. Clone the repository
  2. Open index.html in a web browser
  3. For development with live reload, use any local server

Adding New Data

  1. Update the CSV files with new information
  2. Run appropriate scripts from the scripts/ folder
  3. Regenerate cover art if needed using download scripts

Contributing

  • All album descriptions marked "(by Claude)" were AI-generated based on historical research
  • Original Rolling Stone descriptions preserved where available
  • Cover art sourced from iTunes API with proper attribution

📜 License

This project is for educational and research purposes. Album artwork and descriptions are used under fair use for educational commentary and criticism.

  • Rolling Stone rankings: © Rolling Stone Magazine
  • Album artwork: © Respective record labels and artists
  • Code and compilation: Open source

🙏 Acknowledgments

  • Rolling Stone Magazine for the original rankings and descriptions
  • iTunes API for high-quality album artwork
  • Wikipedia contributors for additional album research
  • Claude AI for data processing assistance and missing descriptions

Explore the greatest albums of all time and discover how musical tastes and recognition have evolved between 2020 and 2023.

🎧 Start Exploring →