Break Reminder Overlay

WHAT IT DOES

Break Reminder Overlay displays a full-screen break reminder at configurable intervals, encouraging you to step away from the screen and take care of your health. The overlay shows the current time, a motivational message, and a list of suggested break activities such as stretching, hydrating, and resting your eyes. You can choose to "Start Break" (which resets the timer) or "Snooze" the reminder for a configurable duration. The tool helps prevent eye strain, reduce fatigue, and maintain healthier browsing habits by gently nudging you to take regular breaks during long sessions.

WHERE IT RUNS

This extension works on any website across the entire web. It functions on social media, news sites, work documents, coding environments, and any page where you spend extended periods of time. The tool works across all domains and adapts to single-page applications and dynamically loaded content.

HOW TO USE

Install the extension and navigate to any website. A timer starts counting down to the next break. When the timer reaches zero, a full-screen overlay appears with a break reminder. Choose "Start Break" to acknowledge the reminder — the overlay closes and the timer resets to the full interval. Choose "Snooze" to dismiss the reminder and postpone it for the configured snooze duration (default 10 minutes). Use the overlay panel to configure the break interval (default 60 minutes), snooze duration, toggle notifications on or off, and customize the list of break activities (comma-separated). Toggle the tool on or off for the current site, or click "Take Break Now" to manually trigger a reminder at any time.

TECHNICAL SECTION — TIMER ENGINE AND OVERLAY MANAGEMENT

The extension uses a setInterval-based timer that ticks every second, decrementing a counter that tracks the remaining time until the next break. The timer is resilient to page navigation — it resets when the page changes or when the user navigates to a new URL. When the counter reaches zero, the extension triggers the break overlay. The overlay is constructed using DOM methods, creating a full-screen modal with a semi-transparent backdrop, motivational messages (randomly selected from a curated list), and activity suggestions (parsed from the user's custom list). The "Start Break" button resets the timer to the full interval and dismisses the overlay, while the "Snooze" button sets the timer to a shorter snooze duration. Both actions clear and restart the timer. The timer runs continuously as long as the extension is enabled for the current site, with the remaining time displayed in the status area of the panel.

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 next break countdown; 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 break activity 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 timer is based on real-time clock ticks and may drift slightly if the browser tab is backgrounded or the system is under heavy load. The overlay is a gentle reminder, not a strict enforcement tool — you can always dismiss it and continue browsing. The activity suggestions are customizable, allowing you to add your own preferred break activities. Notifications require GM_notification support in your browser and may not work in all configurations.