YouTube Bulk Channel Unsubscribe Inactive

WHAT IT DOES

YouTube Bulk Channel Unsubscribe Inactive is a subscription hygiene tool that helps you clean up your YouTube subscriptions by identifying and bulk-unsubscribing from channels that haven't uploaded recently. Instead of manually scrolling through your subscription list, clicking each channel, checking their last upload date, and then clicking unsubscribe, this script automates the entire process. It scans the current page for subscription items, extracts channel names and upload activity indicators, then flags channels whose last upload exceeds your configurable inactivity threshold (default 180 days). The script presents these inactive channels as a scrollable checklist showing the channel name and how long ago they last uploaded. You can select individual channels, use Select All/Deselect All toggles, and unsubscribe from your selections in configurable batches. The tool handles the complete unsubscribe workflow: clicking the Subscribe button to open the confirmation dialog, and clicking the confirm button to finalize the unsubscribe action. Real-time progress updates show how many channels have been processed, and the list automatically refreshes after completion.

WHERE IT RUNS

This script operates exclusively on YouTube (*.youtube.com) as a userscript injected through the BotGentz extension. It runs within the context of your current browser tab—it cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify subscription items, channel names, channel links, and Subscribe button states. It analyzes upload date information from video metadata, "uploaded X ago" text, and channel activity indicators. All operations occur locally in your browser; no data is sent to external servers. The script uses YouTube's native interface to perform unsubscribes through your authenticated session.

HOW TO USE

1. Navigate to your YouTube Subscriptions page (https://www.youtube.com/feed/channels) or any page displaying a list of subscribed channels.

2. Click the BotGentz extension icon and select "YouTube Bulk Channel Unsubscribe Inactive" from the script list.

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

4. Set the "Inactivity threshold (days)" to define how many days without uploads qualifies as inactive (default 180 days). Valid range is 30-730 days.

5. Click "Scan Subscriptions" to analyze the current page. The panel displays all inactive channels with their last upload date.

6. Check the boxes next to channels you wish to unsubscribe from. Use "Select All" or "Deselect All" for quick selection.

7. Adjust the "Batch size" number (default 5) to control how many channels are processed per unsubscribe cycle.

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

9. Click "Unsubscribe Selected" to begin. The script processes channels in batches, shows progress, and handles any errors.

10. After completion, the channel list automatically refreshes showing your remaining inactive subscriptions.

WHY IT WORKS WHERE OTHERS FAIL

Many YouTube subscription management tools fail because they attempt to call YouTube's internal API endpoints directly or rely on brittle DOM selectors that change with every Polymer component update. This script takes a different approach: it locates the actual interactive DOM elements YouTube renders—the Subscribe button, the unsubscribe confirmation dialog, and the confirm button—and triggers native click events on them, exactly as a human would. When the Subscribe button is clicked, it toggles to "Unsubscribe," and the script waits for the confirmation dialog to appear. It then finds the confirm button within that dialog, even when its selector changes across YouTube updates. The script also intelligently parses relative time strings like "3 months ago" or "2 years ago" by detecting the numeric value and unit (year, month, week, day, hour, minute, second) and converting them into days for comparison against the inactivity threshold. By interacting at the UI layer rather than the framework layer, and by using human-like interaction speeds with controlled delays (300ms between actions and 500ms between batches), it remains functional across YouTube's frequent code changes while avoiding anti-bot detection.

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. YouTube periodically updates its website layout, Polymer components, and UI selectors; if the script stops working, an updated version may be released. This script does not store, transmit, or process any of your YouTube data outside your local browser. It does not access your password, hidden inputs, or file inputs. All unsubscribe actions are performed through YouTube's own authenticated session using the official user interface. Unsubscribing removes channels from your subscription feed—you can always resubscribe later. Use responsibly and review your selections carefully before confirming.