Spotify Bulk Save Album to Library

WHAT IT DOES

Spotify Bulk Save Album to Library solves a common music library management challenge: saving multiple albums to your Spotify library is tedious when done one at a time. While Spotify allows saving individual albums, there is no native way to select and save many albums simultaneously. This tool reads your current Spotify album view, new releases page, or search results, detects all visible albums, and displays them in a scrollable checklist with album names, artists, and release dates. You select the albums you want to save, optionally filter by artist or album name, and click "Save Selected Albums." The tool then processes each selected album sequentially through Spotify's Web API, saving them to your library. A preview shows your selection before saving, and progress tracking shows each album as it's saved. The tool can optionally skip albums already in your library to avoid duplicates.

WHERE IT RUNS

This extension panel runs directly inside your browser as an overlay on any Spotify page displaying albums. It works on album views, new releases sections, artist discographies, and search results. The tool detects albums from the page's DOM and uses Spotify's Web API (via GM_xmlhttpRequest) for library operations. It requires no additional API keys beyond your existing authenticated session — the tool extracts your access token from the page.

HOW TO USE

After installing the BotGentz extension and activating Spotify Bulk Save Album to Library, navigate to any Spotify page showing albums (an album view, new releases, or search results). Click the extension icon in your browser toolbar to open the panel. The tool automatically detects all albums displayed in the current view. Each album appears with its name, artist, and release date alongside a checkbox. Use the "Select All" toggle or individually check albums. Optionally, use the filter input to narrow down by album name or artist. Toggle "Skip albums already in library" to avoid saving duplicates. The preview section shows how many albums are selected. Finally, click "Save Selected Albums." A confirmation dialog appears before the save begins. The tool processes each album with a 500ms delay, showing progress as each album is saved. A notification appears when all albums have been processed.

TECHNICAL OPERATION — Spotify Web API Library Management with Token Extraction

This tool combines DOM-based album detection with API-based library operations for reliability. It first scans the page for album elements using selectors like `[data-testid="album-card"]`, `.album-card`, and `.card`, extracting album names, artists, release dates, and IDs. For the save operation, the tool constructs a PUT request to Spotify's `/me/albums` endpoint with the album IDs as query parameters. When the "skip existing" option is enabled, the tool first makes a GET request to `/me/albums/contains` to check whether each album is already in the user's library before attempting to save it. Authentication is handled by extracting the user's access token from the page's scripts (using regex to find `accessToken:"..."`), meta tags, or localStorage. The API approach is more reliable than DOM-based simulation because it works independently of Spotify's UI structure, supports proper error handling with HTTP status codes, and can handle large numbers of albums efficiently. A 500ms delay between saves prevents rate limiting and API congestion.

THE PANEL

The extension panel is fully draggable and remembers its position per site session. It snaps to the nearest edge of the browser viewport when dragged within 50 pixels of any side. You can collapse the panel to a compact title bar using the minimize button, preserving your selection state. The panel resizes vertically by dragging the bottom edge. Press the Escape key to close the panel instantly without losing your album selection. The preview updates in real-time as you select albums or apply filters.

PLEASE NOTE

This tool requires the free BotGentz extension to function. The script uses Spotify's Web API and requires your session to be authenticated. It does not store, transmit, or log any album data, library information, or user activity. All API requests are made locally from your browser session. Spotify's API has rate limits; the tool uses a 500ms delay between saves to avoid rate limiting. The tool relies on extracting your access token from the page, which may expire if your session times out. Spotify may update its DOM structure over time, which could affect album detection; we monitor and release compatibility updates as needed. The "Skip existing" feature uses additional API calls, which may slow down processing for large selections but prevents duplicate saves.