Newsletter Popup Auto-Dismisser

WHAT IT DOES

This script automatically scans for and dismisses newsletter signup popups, subscription overlays, and modal dialogs that interrupt your browsing experience. It detects popups using selectors, class names, and position-based detection, then finds and clicks the close button, dismisses by clicking the overlay, or sends the Escape key. A counter badge shows how many popups were dismissed, and per-site memory prevents repeated dismissal attempts on the same page. Browse without interruptions—newsletter popups disappear before you even see them.

WHERE IT RUNS

The script works on any page with newsletter popups, subscription overlays, or modal dialogs—news sites, blogs, e-commerce stores, and any website with signup prompts. It detects popups regardless of framework and handles both static and dynamically loaded overlays.

HOW TO USE

After installation, the script automatically dismisses popups based on your settings. A badge appears showing the count of dismissed popups. Click the badge to open the panel. Customize: enable or disable auto-dismissal, choose dismissal delay (ms), set max attempts, enable dismissal on page load or on scroll (with configurable threshold), enable per-site memory to avoid repeated dismissals, show/hide the count badge, choose badge position, and toggle debug mode. Click "Scan & Dismiss Now" to manually trigger a scan. The script also detects exit-intent popups (mouse leaving the page) and dismisses them.

TECHNICAL MECHANISM

The script uses a multi-stage popup detection and dismissal pipeline. First, it scans the DOM using a comprehensive set of selectors for popups, modals, overlays, and newsletter containers (.popup, .modal, .overlay, .newsletter, .subscribe) with case-insensitive attribute matching. Second, it uses position-based detection for fixed/absolute elements with high z-index (>100) that cover significant screen area and contain newsletter-related keywords. Third, it locates the close button by searching for common selectors ( .close, .dismiss, [aria-label*="close"] ) and scanning children for close text (×, ✕, "Close", "Dismiss"). Fourth, it attempts dismissal by clicking the close button, clicking the overlay, or sending the Escape key. Fifth, it stores dismissed URLs in per-site storage using GM_setValue to avoid re-dismissing the same popup on repeat visits. The script uses a MutationObserver to detect dynamically loaded popups and re-applies dismissal.

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. Popup detection relies on class names and HTML patterns which may vary across sites. The script does not access, store, or transmit any personal data or browsing history. All processing happens locally in your browser and never leaves your device.