Hulu Bulk Watchlist Cleaner

WHAT IT DOES

Hulu Bulk Watchlist Cleaner is a streaming library management tool that streamlines the process of removing multiple shows and movies from your Hulu watchlist. Instead of manually opening each title, finding the remove option, and confirming the removal—a process that can be tedious when clearing out a large watchlist—this script automates the entire workflow. It scans the current Hulu watchlist or My Stuff page, identifies all shows and movies with their titles and current status (Watching, Caught Up, Not Started), and presents them as a scrollable checklist with status indicators. You can filter items by status, select individual titles, use Select All/Deselect All toggles, and remove your selections from the watchlist in configurable batches. The tool handles the complete interaction sequence: clicking the remove button (or finding it via the More/Options menu), and confirming the removal. Real-time progress updates show how many titles have been removed, and the list automatically refreshes after completion. This is ideal for Hulu users who want to declutter their watchlist and keep only the shows they're actively watching.

WHERE IT RUNS

This script operates exclusively on Hulu (*.hulu.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 watchlist items using Hulu's selectors (.watchlist-item, .my-stuff-item, .show-tile), extracts titles and status indicators, and interacts with Hulu's native UI controls—Remove buttons, More/Options menus, and confirmation dialogs—to perform removals. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to your Hulu watchlist or My Stuff page.

2. Click the BotGentz extension icon and select "Hulu Bulk Watchlist Cleaner" from the script list.

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

4. Review the displayed items, showing titles and status (Watching, Caught Up, Not Started).

5. Use the "Filter by status" dropdown to show only items with a specific status.

6. Adjust the "Batch size" number (default 3) to control how many items 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 items you wish to remove. Use "Select All" or "Deselect All" for quick selection.

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

10. After completion, the item list automatically refreshes showing your remaining watchlist items.

WHY IT WORKS WHERE OTHERS FAIL

Many Hulu automation tools fail because they attempt to call Hulu's internal API endpoints or rely on brittle DOM selectors that change with every Hulu UI update. This script takes a resilient approach: it locates the actual interactive DOM elements Hulu renders—the remove button, the More/Options menu, and confirmation dialogs—and triggers native click events on them, exactly as a human would. When the remove button is not directly visible, the script uses the More button to access the remove option from the dropdown menu. It handles any confirmation dialogs by waiting for the confirm button and clicking it. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed and avoid triggering Hulu's rate limiting. By interacting at the UI layer rather than the framework layer, it remains functional across Hulu'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. Hulu periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script removes selected items from your watchlist; this action cannot be undone through the script (Hulu may allow re-adding). This script does not store, transmit, or process any of your Hulu data outside your local browser. It does not access your password, hidden inputs, or file inputs. All watchlist removals are performed through Hulu's own authenticated session using the official user interface. Use responsibly and review your selections carefully before confirming removals.