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
Global Chart Sources
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.
Let's say "Tauba Tauba" appears on 3 platforms:
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:
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
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.
Latest QA test run covers 17 categories across 238 individual tests:
Run Tests Yourself: Open the test runners in your browser:
QA Test Suite (238 tests) ยท
E2E Tests (75 tests) ยท
Unit Tests (59 tests)