YouTube Music True Shuffle
An open-source Chrome extension that fixes YouTube Music's biased shuffle for good
Overview
YouTube Music True Shuffle is an open-source Chrome extension built to solve a problem that frustrates heavy YouTube Music users: the platform's built-in shuffle isn't really random. It tends to repeat tracks, favor recently added songs, or only shuffle a small subset of a playlist instead of the whole thing.
This extension fixes that by physically reordering the tracks inside a playlist through the YouTube Music API, rather than relying on a session-based shuffle layer that resets or behaves inconsistently.
Instead of faking randomness during playback, the extension rewrites the actual playlist order — so the shuffle finally sticks.
The Problem
Users with large, long-standing YouTube Music playlists ran into the same recurring issues:
- Shuffle repeating the same tracks within a single session
- Older or less-played songs rarely surfacing
- Shuffle only affecting a portion of large playlists
- No way to get a genuinely randomized listening experience without manually rebuilding the playlist
The Solution
Instead of layering another shuffle algorithm on top of YouTube Music's playback engine, the extension reorders the actual track sequence of the playlist via the YouTube Music API. Once shuffled, every song has an equal chance of being repositioned anywhere in the list, and the new order persists rather than resetting each session.
Key Features
True Randomization
Physically reorders playlist tracks rather than simulating shuffle during playback, so the randomization actually sticks.
Large Playlist Support
Built to handle playlists with up to 30,000 songs without slowing down or timing out.
Instant Execution
Reordering happens instantaneously, with no noticeable delay before playback continues.
Lightweight & Open Source
Runs as a simple Chrome extension with the full source available on GitHub for anyone to inspect, fork, or contribute to.
Technologies Used
The extension was built directly on top of YouTube Music's own API to manipulate playlist order at the source:
- Chrome Extension (Manifest-based architecture)
- YouTube Music API integration
- TypeScript
Results
The extension gives YouTube Music users the genuinely randomized listening experience the platform's native shuffle doesn't provide, even on very large libraries.
| Metric | Before | After | Impact |
|---|---|---|---|
| Shuffle Coverage | Partial — small subset of playlist | Full playlist, every track | 100% coverage |
| Max Playlist Size Supported | Inconsistent on large lists | Up to 30,000 songs | Reliable at scale |
| Reorder Speed | N/A (native shuffle is session-based) | Instant, no playback delay | 0 delay |
| Cost to User | N/A | Free & open source | $0 |
Open Source
Anybody can open issues or pull requests on the project's GitHub repository.
Conclusion
YouTube Music True Shuffle is a focused example of solving a real, everyday annoyance with a small, well-engineered tool. By working directly with the YouTube Music API instead of fighting against the platform's playback layer, the extension delivers shuffle behavior that actually works as users expect it to.
