Universal Notification Badge Clearer

WHAT IT DOES

Universal Notification Badge Clearer scans the page for notification badges—those numbered red circles that appear on icons, tabs, and buttons—and allows you to clear them with a single click. The script detects common notification badge patterns using a comprehensive set of selectors and injects a small "Clear" button next to each badge, or automatically clears them based on your preferences. A floating panel shows all found notification badges grouped by section, with the ability to clear individual badges or clear all badges at once. You can also enable auto-clear on page load to automatically dismiss all badges when you visit a page, keeping your interface clean and distraction-free.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage that displays notification badges, including social media sites, email clients, project management tools, messaging apps, and news platforms. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, modifying the page's DOM locally without sending any data to external servers.

HOW TO USE

After installation, the script automatically scans the page for notification badges. A floating panel appears showing all detected badges with their location and current count. Click the "✕ Clear" button next to any badge to clear it individually, or click "Clear All" to dismiss all badges at once. The floating counter shows the total number of badges found. Open the main panel to customize behavior: enable or disable the badge clearer, toggle the panel and counter visibility, adjust detection sensitivity, choose the clear method (click trigger, element removal, or hybrid), or exclude specific sections using CSS selectors. Enable "Auto-clear on load" to automatically clear badges every time you visit a page.

THE MECHANISM THAT MAKES IT WORK

The script uses a multi-strategy detection system that scans the DOM for elements matching common badge patterns—elements containing numeric text that are visually styled as notification indicators. The detection engine checks selectors like .badge, .notification-badge, .unread-count, and elements with data attributes, then validates that the text content is a non-zero number. For clearing, the script uses a hybrid approach: it first attempts to trigger a click on the badge or its parent clickable element (which often triggers the site's own clearing mechanism), and if that fails, it removes the badge element from the DOM or hides it. The clear method is configurable per user preference. The floating panel uses a MutationObserver to monitor the page for dynamically added badges, ensuring the list stays current. The counter updates in real-time as badges are cleared.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the badge clearer's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the tool's aesthetic. It includes dropdown menus for detection sensitivity (low, medium, high) and clear method (click trigger, element removal, hybrid), a text input for CSS selectors to exclude specific badges, and toggle switches for enabling the clearer, showing the badge panel, showing the counter, auto-clearing on load, and clearing all on load. Action buttons allow you to scan for badges, save settings, or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The script works by detecting and removing badge elements or simulating clicks on them; some sites may have security measures that prevent automated badge clearing. The "click trigger" method may not work on all sites, but the hybrid mode provides the best compatibility. The exclude selectors field allows you to prevent the script from affecting specific badge elements that you want to keep. No data is collected, stored, or transmitted by this script; all processing is performed locally in your browser. The script may not detect badges rendered via canvas or WebGL, as these are not part of the DOM.