Doom-Scroll Interrupt Prompt

WHAT IT DOES

Doom-Scroll Interrupt Prompt detects when you are continuously scrolling down a webpage for an extended period and displays a gentle prompt reminding you to take a break. The tool tracks both the number of scroll actions and the total time spent scrolling. When you exceed either threshold, a full-screen prompt appears with two options: "Continue Scrolling" or "Take a Break." Choosing "Take a Break" pauses the timer and shows a brief reminder to step away, automatically resuming after 30 seconds. This helps you stay mindful of your scrolling habits, reduce digital fatigue, and maintain healthier browsing patterns.

WHERE IT RUNS

This extension works on any website across the entire web. It functions on social media feeds, news sites, forums, blog archives, and any page that involves continuous scrolling. The tool works across all domains and adapts to single-page applications and infinite-scroll content.

HOW TO USE

Install the extension and navigate to any website. The tool begins tracking your scrolling automatically. When you exceed the configured scroll threshold (number of downward scroll actions) or time threshold (seconds spent scrolling), a prompt appears. Choose "Continue Scrolling" to dismiss the prompt and continue browsing — your scroll count resets, and the timer restarts. Choose "Take a Break" to pause the timer, showing a brief "Break time" message; scrolling resumes automatically after 30 seconds. Use the overlay panel to configure the scroll threshold (default 15 actions), time threshold (default 30 seconds), and prompt frequency (how many interrupts before the counter resets). Toggle the tool on or off for the current site, or click "Reset Tracking" to reset all counters manually.

TECHNICAL SECTION — SCROLL DETECTION AND INTERRUPT LOGIC

The extension uses a scroll event listener that tracks the vertical scroll position on each scroll event. It only counts downward scrolling (when the current scroll position is greater than the previous position), ignoring upward scrolls to avoid false triggers. The scroll counter increments on each downward scroll event, while the time tracker measures the total elapsed time since the first downward scroll in the current session. Both counters run independently — whichever threshold is reached first triggers the interrupt prompt. When the prompt appears, a full-screen overlay is created using DOM manipulation, with event handlers for the "Continue" and "Take a Break" buttons. The "Continue" option resets both counters and dismisses the overlay, while "Take a Break" pauses the timer, hides the overlay, and schedules a 30-second cooldown before resuming tracking. The prompt frequency setting limits how many interrupts can appear before the counter resets, preventing repetitive prompts during prolonged browsing sessions.

THE PANEL — DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The overlay panel is fully interactive and designed for seamless multitasking. Drag it anywhere on the screen using the handle at the top of the panel; the position is saved per site so it stays where you left it across sessions. The panel includes a snap-to-edge feature that gently anchors the overlay to the nearest screen edge when released. Click the collapse button to minimize the panel to a compact pill showing the current interrupt status; expand it again with a single click. Resize the panel vertically by dragging the bottom-right corner to view more controls. Press the Escape key at any time to instantly close the overlay; it reappears on the next page navigation or refresh.

PLEASE NOTE

This extension requires the free BotGentz companion extension to function, as it provides the underlying content script injection and cross-origin communication framework. No personal data, browsing history, or scroll data is stored, transmitted, or shared. Settings are stored locally in your browser using GM_setValue and are never sent to any external server. The extension does not access or store login credentials, financial data, or personally identifiable information. The scroll detection counts individual scroll events, which may vary between browsers and input methods (mouse wheel, touch, keyboard). The timer is based on elapsed time since the first scroll, not active scroll duration. The prompt is designed as a gentle reminder, not a strict enforcement mechanism — you can always dismiss it and continue browsing. The tool may not detect scrolling on pages with custom scroll implementations or virtual scrolling.