Download Bar Auto-Clear

WHAT IT DOES

This script keeps your download bar clean and clutter-free by automatically removing download items once they complete. Instead of manually clicking clear buttons or letting downloaded files pile up, the script watches for finished downloads and removes them after a configurable delay. You can choose to clear only successful downloads while keeping failed ones visible for troubleshooting, or wait until all active downloads complete before clearing anything. The script also provides visual feedback with smooth fade-out animations and optional desktop notifications so you always know when items have been cleared.

WHERE IT RUNS

The script works on any page that displays a download bar, including the native download shelves in Chrome, Edge, Brave, and other Chromium-based browsers. It also works on custom download managers and download list implementations found on some websites and internal tools. The script automatically detects download bars regardless of how they're rendered, using intelligent selectors that adapt to different browser implementations.

HOW TO USE

After installation, the script starts working automatically. Use the panel to customize its behavior: enable or disable auto-clear, adjust the delay before clearing (1 to 60 seconds), and choose whether to clear only successful downloads or all completed items. Toggle "Clear only when all downloads complete" to wait until every active download finishes before clearing any items. Turn notifications on or off depending on your preference. Use the "Clear Now" button to manually trigger a cleanup, or "Scan Now" to check for the download bar and report how many items are found. Reset to defaults anytime to restore the original settings.

TECHNICAL MECHANISM

This script operates without access to the browser's download API, which is unavailable in userscript contexts. Instead, it uses DOM observation and polling to detect download bar visibility and item status changes. The script employs a mutation observer to watch for new download items being added to the page, and a periodic interval scan to check for status updates on existing items. To determine completion, it examines element attributes (data-status, data-state, aria-label), CSS classes, text content for keywords like "complete" or "finished", and progress bar values. The script tracks which items have already been processed to avoid duplicate removals, and uses CSS transitions to create smooth fade-out animations when items are cleared.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The download bar HTML structure varies between browsers and browser versions, and may change with updates. If the script cannot find your download bar or stops working after a browser update, check for script updates or contact the developer. The script does not access, store, or transmit your download history or any personal data. All detection and clearing logic runs locally in your browser, and no information ever leaves your device.