Spotify Bulk Playlist Duplicate Track Remover

WHAT IT DOES

Spotify Bulk Playlist Duplicate Track Remover is a playlist management tool that streamlines the process of identifying and removing duplicate tracks from Spotify playlists. Instead of manually scrolling through a playlist, spotting duplicates, and removing them one by one—a process that can be tedious and error-prone—this script automates the entire workflow. It scans the current Spotify playlist page, extracts all tracks with their titles and artists, identifies duplicates based on title/artist combination (or title only), and presents them as grouped checklists showing the original track (kept) and all duplicate copies (marked for removal). You can select individual duplicate groups, use Select All/Deselect All toggles, and remove your selections from the playlist in configurable batches. The tool handles the complete interaction sequence: opening the context menu for each duplicate, selecting the remove option, and confirming the removal. Real-time progress updates show how many duplicates have been removed, and the list automatically refreshes after completion. This is ideal for Spotify users who want to keep their playlists clean and organized.

WHERE IT RUNS

This script operates exclusively on Spotify (*.spotify.com/*) as a userscript injected through the BotGentz extension. It runs within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify tracks using Spotify's selectors (.tracklist-row, .track-row, .playlist-track), extracts titles and artists, groups duplicates, and interacts with Spotify's native UI controls—More/Options menus, Remove buttons, and confirmation actions—to perform removals. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Open any Spotify playlist page in your browser.

2. Click the BotGentz extension icon and select "Spotify Bulk Playlist Duplicate Track Remover" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current playlist for tracks.

4. Review the detected duplicate groups, showing the original track (green) and duplicate copies (red).

5. Choose the matching criteria: "Title + Artist" (default) or "Title Only" from the dropdown.

6. Adjust the "Batch size" number (default 3) to control how many duplicates are removed per batch.

7. Toggle "Confirm before each batch" if you want a confirmation popup before each batch executes.

8. Check the boxes next to duplicate groups you wish to clean. Each group removes all duplicates while keeping the original.

9. Click "Remove Duplicates" to begin. The script processes duplicates in batches, shows progress, and handles errors.

10. After completion, the playlist automatically refreshes showing your cleaned list.

WHY IT WORKS WHERE OTHERS FAIL

Many Spotify automation tools fail because they attempt to call Spotify's internal API endpoints or rely on brittle DOM selectors that change with every Spotify UI update. This script takes a resilient approach: it locates the actual interactive DOM elements Spotify renders—the track rows, the More/Options button, the Remove option in the context menu—and triggers native click events on them, exactly as a human would. The script intelligently groups duplicates using a flexible matching system that can compare by title+artist (most accurate) or title only (for cases where artists vary). When removing duplicates, it uses the context menu to access the remove option, which is the most reliable method across Spotify's UI variations. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed and avoid triggering Spotify's rate limiting. By interacting at the UI layer rather than the framework layer, it remains functional across Spotify's frequent code updates.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. Spotify periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script removes duplicate tracks from the playlist—one copy (the first encountered) is always kept. This action cannot be undone through the script (Spotify may allow re-adding). This script does not store, transmit, or process any of your Spotify data outside your local browser. It does not access your password, hidden inputs, or file inputs. All playlist modifications are performed through Spotify's own authenticated session using the official user interface. Use responsibly and review selections carefully before confirming.