How TLDR Music Works

Understanding how we create India's most comprehensive music chart

? What is TLDR Music?

TLDR Music is an aggregated music chart that combines data from multiple streaming platforms to show you what songs are truly popular. Instead of checking Spotify, Apple Music, YouTube, and other platforms separately, we do the work for you and create unified "Top 25" charts for both India and Global music.

Think of it like this: If a song is #1 on Spotify but nowhere on Apple Music, is it really the most popular song? TLDR Music considers popularity across ALL major platforms to give you a more accurate picture of what's actually trending.

๐ŸŒ India & Global Charts

TLDR Music now offers two chart views that you can switch between using the toggle in the header:

  • ๐Ÿ‡ฎ๐Ÿ‡ณ

    India Top 25

    Aggregates data from Spotify India, Apple Music India, JioSaavn, Gaana, YouTube Music India, Billboard India, and regional charts. Shows what India is listening to - a mix of Bollywood, regional, and international hits.

  • ๐ŸŒ

    Global Top 25

    Aggregates data from Spotify Global Top 50, Apple Music Global Top 100, and Billboard Hot 100. Shows what the world is listening to - primarily Western and international hits.

Both charts use the same weighted ranking algorithm - the only difference is which platform charts are used as data sources.

* Where Does the Data Come From?

We collect chart data from 7+ music platforms daily. Each platform has a different "weight" based on how reliable and representative it is:

India Chart Sources

Apple Music India
Weight: 1.5x (Highest)
Spotify India
Weight: 1.5x (Highest)
Billboard India
Weight: 1.2x
YouTube Music
Weight: 1.0x
JioSaavn
Weight: 1.0x
Gaana
Weight: 0.8x
Spotify Viral India
Weight: 0.9x

Global Chart Sources

Spotify Global Top 50
Weight: 1.5x
Apple Music Global
Weight: 1.5x
Billboard Hot 100
Weight: 1.2x

Why different weights? Apple Music and Spotify have the highest weights because they have the most accurate and standardized data. Platforms like Gaana have lower weights because their charts can sometimes be influenced by promotional content.

= The Ranking Algorithm

Here's how we calculate the final ranking, explained step by step:

  • 1

    Collect Data

    We scrape the top 50 songs from each platform's India chart every week. That's potentially 400+ songs!

  • 2

    Match Same Songs

    The same song might appear as "Tauba Tauba" on one platform and "Tauba Tauba (From Bad Newz)" on another. We use smart matching to identify these as the same song.

  • 3

    Calculate Position Score

    A song's position on each chart matters. Being #1 gives you a score of 1.0, while #50 gives you only 0.02. The formula is simple: (50 - position + 1) / 50

  • 4

    Apply Platform Weights

    We multiply each position score by the platform's weight. So being #1 on Spotify (1.5x) is worth more than being #1 on Gaana (0.8x).

  • 5

    Add It All Up

    A song's final score is the sum of all its weighted position scores from every platform it appears on.

Final Score = Sum of (Platform Weight x Position Score)
// Where Position Score = (50 - position + 1) / 50
Example Calculation

Let's say "Tauba Tauba" appears on 3 platforms:

Spotify #1: 1.5 x (50-1+1)/50 = 1.5 x 1.0 = 1.50
Apple Music #3: 1.5 x (50-3+1)/50 = 1.5 x 0.96 = 1.44
YouTube Music #5: 1.0 x (50-5+1)/50 = 1.0 x 0.92 = 0.92
Total Score = 1.50 + 1.44 + 0.92 = 3.86

# What If Songs Have the Same Score?

When two songs have identical scores, we use tiebreakers to decide which one ranks higher:

  • 1st
    Number of Platforms - A song on 6 platforms beats one on 4 platforms (more widespread = more popular)
  • 2nd
    YouTube Views - If still tied, the song with more YouTube views wins

@ Regional Spotlights

India's music scene is incredibly diverse! Beyond the main chart, we also track regional charts for Hindi, Tamil, Telugu, and Punjabi music. These have lower weights (0.6-0.7x) in the main ranking to prevent regional hits from dominating the national chart, but they're showcased separately in the Regional Spotlights section.

+ What's New

TLDR Music has been upgraded with several new features to enhance your experience:

  • 1

    India & Global Toggle

    Switch between India and Global charts with the toggle in the header. India aggregates local platforms like JioSaavn and Gaana, while Global pulls from Spotify Global, Apple Music Global, and Billboard Hot 100.

  • 2

    Rank Movement Tracking

    See how songs are moving on the charts! Green arrows show songs climbing up, red arrows show drops, and "NEW" badges highlight fresh entries to the chart.

  • 3

    Cloud-Powered API

    Chart data is served via a dedicated REST API hosted on Google Cloud Run, connected to MongoDB for fast, reliable data delivery with intelligent caching.

  • 4

    Lyrics Support

    View synced and plain lyrics for most songs. Click the lyrics button while playing to see the words as you listen.

  • 5

    Enhanced Regional Charts

    Regional songs now include album artwork, YouTube videos, and metadata. Play any regional song directly from the spotlights section.

  • 6

    Theater Mode

    Watch music videos in an immersive full-width view. Click the video button on the hero section or player bar to enter theater mode.

  • 7

    Automated Daily Updates

    Charts are automatically refreshed daily at 10 PM IST via Google Cloud Scheduler. No manual intervention needed - always fresh data!

  • 8

    Google Sign-In & Cloud Sync

    Sign in with your Google account to sync your favorites, play history, and queue across all your devices. Browse freely - login is only required when you want to play songs.

  • 9

    User Profile Page

    View your profile with stats, liked songs, and recently played tracks. Click your avatar in the header to access your personalized music dashboard.

For Developers: The TLDR Music API is available for integration. Endpoints include /chart/current, /search, and /regional. View API Documentation

Your Personal Features

TLDR Music includes personal features that save automatically. Sign in with Google to sync across devices, or use locally without an account - your choice!

Cloud Sync: Sign in with Google to sync your favorites, history, and queue across all your devices. Your data is securely stored in MongoDB and accessible anywhere.

  • Favorites

    Click the heart button on the player bar (or press H) to favorite songs. Your favorites appear in a dedicated section at the top of the page for quick access.

  • Queue

    Build your own playlist! Add songs to queue and they'll play before the chart continues. Click the queue button (or press Q) to view and manage your queue.

  • Shuffle & Repeat

    Press S to toggle shuffle mode for random playback. Press R to cycle through repeat modes: Off โ†’ Repeat All โ†’ Repeat One.

  • Listening History

    Your recently played songs are automatically tracked (up to 50 songs). Find them in the queue panel for quick replay.

🎶 Playlists

Create and manage custom playlists to organize your favorite music. Press P to open the playlists view, or click the Playlists button in the sidebar.

  • +

    Create Playlists

    Click "Create Playlist" to start a new collection. Give it a name and optionally add a description. Your playlists sync across devices when signed in.

  • 💾

    Add Songs

    Use the "+" button on any song to add it to a playlist. You can also right-click (or long-press on mobile) for the context menu with more options.

  • 🎨

    Custom Artwork

    Personalize your playlists with custom cover images. Click the artwork area when editing a playlist to upload your own image, or let the app auto-generate a collage from your songs.

  • 🔗

    Share Playlists

    Share your playlists with friends! Click the share button to generate a public link. Recipients can view and play your playlist without needing an account.

  • 📄

    Export Playlists

    Export your playlists in multiple formats: plain text, JSON, or CSV. Perfect for backing up your music collection or importing into other apps.

  • Reorder & Organize

    Drag and drop songs to reorder them within a playlist. Sort your playlists by name, date created, or recently updated from the dropdown menu.

Recently Played: Your recently played playlists appear at the top of the playlists view for quick access. The section updates automatically as you listen.

Keyboard Shortcuts

Power users can control everything with keyboard shortcuts:

Space
Play / Pause
Toggle playback
H
Favorite
Add/remove from favorites
S
Shuffle
Toggle shuffle mode
R
Repeat
Cycle repeat modes
Q
Queue
Show/hide queue panel
L
Lyrics
Show/hide lyrics panel
P
Playlists
Open playlists view
Previous
Play previous song
Next
Play next song
Seek Back
Rewind 10 seconds
Seek Forward
Skip 10 seconds

! Why This Approach Works

Cross-platform validation: A song needs to perform well on MULTIPLE platforms to rank high. This filters out songs that are artificially boosted on just one platform and surfaces music that's genuinely popular across India's diverse streaming landscape.

Our algorithm rewards songs that are:

  • Ranking high (not just appearing) on charts
  • Popular across multiple platforms (not just one)
  • Performing well on reliable, established platforms
  • Actually being listened to (YouTube views as final tiebreaker)

~ About the Project

The Story

TLDR Music started as a personal project to solve a simple problem: figuring out what music is actually trending in India without checking multiple apps. What began as a weekend experiment has grown into a fully automated system that scrapes, ranks, and presents music data daily.

The entire project is built with Python for the backend scraping and ranking engine, a lightweight vanilla JavaScript frontend, and Google Cloud for hosting and automation.

< Tech Stack

Python Scraping & Ranking
FastAPI REST API
MongoDB Database
GCP Cloud Run & Scheduler
Playwright Web Scraping
GitHub Pages Hosting

Quality Assurance

TLDR Music is thoroughly tested with a comprehensive QA test suite to ensure reliability across desktop and mobile devices. All tests are automated and run in-browser.

Test Results: 238 Passed, 0 Failed

Latest QA test run covers 17 categories across 238 individual tests:

📱
Responsive Layout
13 tests
👆
Mobile Interactions
12 tests
🌍
Chart Toggle
10 tests
🔗
Cross-Feature
8 tests
🎯
UI State
8 tests
Progress Bar
7 tests
🎭
Regional Songs
4 tests
💾
Data Integrity
8 tests
Accessibility
6 tests
Error Handling
8 tests
🔢
Boundary Cases
9 tests
Performance
5 tests
💀
Skeleton UI
19 tests
👤
Human Usage
35 tests
🎵
Playback
15 tests
🔄
Interaction Flows
24 tests
🎮
Button States
30 tests

Run Tests Yourself: Open the test runners in your browser:

QA Test Suite (238 tests) ยท E2E Tests (75 tests) ยท Unit Tests (59 tests)