Chat Widget Auto-Minimizer

WHAT IT DOES

This script automatically detects and minimizes live chat widgets, support chat buttons, and messaging overlays that appear on websites. It finds the minimize button or clickable header and performs the minimization action, then stores the state per page to prevent re-opening. A counter badge shows how many chat widgets were minimized. Browse without intrusive chat popups—support widgets stay minimized until you actually need them.

WHERE IT RUNS

The script works on any page with live chat widgets—support sites, e-commerce stores, SaaS platforms, and any website with Intercom, Drift, Crisp, Tawk.to, Zendesk, Olark, Chatra, or other chat services. It detects chat widgets regardless of framework and handles both static and dynamically loaded widgets.

HOW TO USE

After installation, the script automatically minimizes chat widgets based on your settings. A badge appears showing the count of minimized widgets. Click the badge to open the panel. Customize: enable or disable auto-minimization, choose minimization delay (ms), set max attempts, enable minimization on page load or on scroll (with configurable threshold), enable per-site memory to avoid re-minimizing on repeat visits, show/hide the count badge, choose badge position, and toggle debug mode. Click "Scan & Minimize Now" to manually trigger a scan. The script also detects chat widgets loaded in iframes and handles them.

TECHNICAL MECHANISM

The script uses a multi-stage chat widget detection and minimization pipeline. First, it scans the DOM using a comprehensive set of selectors for chat widgets (.chat-widget, .live-chat, .support-chat, .intercom-messenger, .drift-widget, .crisp-client, .tawk-min-chat) with case-insensitive matching. Second, it uses position-based detection for fixed/sticky elements in corners with chat-related text or icons. Third, it checks if the widget is already minimized by examining display/visibility styles and size (minimized widgets are typically small bubbles under 80x80px). Fourth, it locates the minimize button by searching for common selectors (.minimize, .collapse, [aria-label*="minimize"]) and scanning children for minimize text (−, _, "Minimize", "Collapse"). Fifth, it attempts minimization by clicking the button, clicking the widget header, or clicking the widget itself. Sixth, it stores minimized URLs in per-site storage using GM_setValue. The script uses a MutationObserver for dynamically loaded widgets and an iframe loader listener.

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. Chat widget detection relies on class names and HTML patterns which may vary across services. 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.