Flickr Bulk Album Assigner

WHAT IT DOES

Flickr Bulk Album Assigner is a photo organization tool that streamlines the process of adding multiple Flickr photos to albums. Instead of manually opening each photo, clicking the "Add to album" button, searching for the album, and saving—a process that can be extremely tedious when organizing hundreds of photos—this script automates the entire workflow. It scans the current Flickr photostream, album, or search results page, identifies visible photos with their titles and album membership status, and presents them as a scrollable checklist. You can select individual photos, use Select All/Deselect All toggles, choose a target album from a dynamically populated dropdown, and add all selected photos to that album in configurable batches. The tool handles the complete interaction sequence: clicking the "Add to album" button (or finding it via the More menu), opening the album picker modal, selecting the target album, and confirming the addition. Real-time progress updates show how many photos have been added, and the list automatically refreshes after completion. This is ideal for photographers, archivists, and anyone who wants to organize their Flickr library efficiently.

WHERE IT RUNS

This script operates exclusively on Flickr (*.flickr.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 photo items using Flickr's selectors (.photo-list-photo-view, .photo-view, .photo-grid-item), extracts photo titles and IDs, detects album membership status, and interacts with Flickr's native UI controls—Add to album buttons, album picker modals, dropdowns, and save/confirm buttons—to perform album assignments. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to any Flickr page containing photos—your photostream, an album, a search results page, or a group pool.

2. Click the BotGentz extension icon and select "Flickr Bulk Album Assigner" from the script list.

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

4. Review the displayed photos, showing titles and an "In Album" indicator if already in a target album.

5. Click "Refresh Albums" to load your available albums into the target dropdown.

6. Select your target album from the dropdown.

7. Adjust the "Batch size" number (default 3) to control how many photos are processed per batch.

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

9. Check the boxes next to photos you wish to add to the album.

10. Click "Add to Album" to begin. The script processes photos in batches, shows progress, and handles errors.

11. After completion, the photo list automatically refreshes showing your updated album statuses.

WHY IT WORKS WHERE OTHERS FAIL

Many Flickr automation tools fail because they attempt to call Flickr's internal API endpoints or rely on brittle DOM selectors that change with every Flickr UI update. This script takes a resilient approach: it locates the actual interactive DOM elements Flickr renders—the "Add to album" button (or the More menu that contains it), the album picker modal, the album dropdown selector, and the save/confirm button—and triggers native click events and value changes on them, exactly as a human would. When adding a photo to an album, the script uses two strategies: first trying to find a direct "Add to album" button on the photo item, and if not available, opening the More menu to find the option. It sets the album selection using both the native value setter and dispatches "input" and "change" events, ensuring Flickr's JavaScript UI registers the update. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed and avoid triggering Flickr's rate limiting.

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. Flickr periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script adds photos to the selected album; if a photo is already in the album, it may be skipped or cause an error. This script does not store, transmit, or process any of your Flickr data outside your local browser. It does not access your password, hidden inputs, or file inputs. All album assignments are performed through Flickr's own authenticated session using the official user interface. Use responsibly and verify the target album before adding multiple photos.