YouTube Playlist Shuffle Fixer

WHAT IT DOES

YouTube Playlist Shuffle Fixer is a browser extension that automatically scans the current YouTube page for playlist items, shuffle controls, and video order indicators. It detects playlist elements by examining the page URL for playlist IDs and finding shuffle control buttons. The extension adds a floating fix shuffle button (🔀) next to the playlist, providing quick access to shuffle controls. Clicking the button opens a panel where you can enable or disable playlist shuffle, fix the shuffle state to match your saved preferences, view the current shuffle status, and store shuffle history locally. The panel displays the playlist title, ID, current shuffle status, and any saved preferences. You can toggle shuffle on/off directly from the panel, restore a saved shuffle preference, or reset to the default state. The extension maintains a playlist shuffle database with shuffle history, notes, and tags for each playlist. The main panel also shows saved playlists with their shuffle states. All data is stored locally in your browser using GM_setValue, ensuring your shuffle preferences persist across page reloads and browser sessions. This helps YouTube users who want to maintain consistent playback order in their playlists, fix shuffle behavior that doesn't persist, or simply toggle shuffle more conveniently.

WHERE IT RUNS

This extension runs on any YouTube page that displays playlist items, shuffle controls, or video order indicators – including YouTube playlist pages, watch pages with playlists, and any page with YouTube playlist content. The extension intelligently adapts to different page structures and supports a wide range of common YouTube display patterns. No manual configuration is required per site; the extension automatically detects playlist elements using the page URL and shuffle controls. This makes it ideal for YouTube users who want to fix shuffle behavior and maintain consistent playback order.

HOW TO USE

Simply install the extension and navigate to any YouTube playlist page. The extension automatically detects the playlist and shows a fix shuffle button (🔀) next to the playlist. Click the button to open the playlist panel. The panel shows the playlist title, ID, and current shuffle status. Use the "Enable Shuffle" toggle to turn shuffle on or off – the change applies immediately. Click "Fix Shuffle (Restore Saved)" to restore the shuffle state you previously saved for this playlist. Click "Reset Shuffle (Default)" to reset to your default shuffle preference. A floating button (📋) appears in the bottom-right corner of the page – click this to open the panel from anywhere. Use the notes section to add notes about playlist content or preferred order. The panel also shows saved playlists with their shuffle states. Use the settings section to set your default shuffle preference and enable or disable auto-fix on playlist load. The "Clear All Playlists" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension uses a combination of DOM detection and event simulation to control playlist shuffle behavior. The playlist ID is extracted from the page URL using regex pattern matching. The shuffle control button is detected using a comprehensive set of CSS selectors targeting aria-label attributes, class names, and YouTube-specific button patterns. The current shuffle state is determined by checking aria-checked attributes, class names (active/on/enabled), and style colors. When toggling shuffle, the extension simulates a click on the shuffle button using the native click() method. The extension also detects when the shuffle state changes and updates the UI indicator accordingly. Shuffle preferences are stored in a structured database keyed by playlist ID, with each playlist entry storing the shuffle state, title, notes, and tags. The auto-fix feature checks the saved preference when a playlist loads and applies it if needed. A MutationObserver detects dynamic content updates and re-scans only when the playlist changes, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The playlist shuffle panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during playlist management. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The shuffle controls and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your playlist viewing workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause shuffle detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all playlist data, shuffle preferences, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. The extension does not read, modify, or interfere with any YouTube content, playlists, or functionality beyond the shuffle controls – it operates on the page content and stores only metadata (playlist IDs, titles, shuffle states, and notes) that you explicitly create. You are responsible for backing up your playlist data if you switch browsers or clear your storage. Use this tool responsibly and in accordance with YouTube's Terms of Service.