Study Timer Pomodoro Overlay

WHAT IT DOES

Study Timer Pomodoro Overlay displays a compact, always-visible Pomodoro timer overlay on any webpage, designed to help you stay focused while studying or working. The timer cycles through focus and break intervals based on the Pomodoro Technique, with configurable intervals for focus, short breaks, and long breaks. A session counter tracks completed focus sessions, and the timer display changes color based on the current phase — green for focus, blue for short breaks, and purple for long breaks. Start, pause, and reset controls are built into the overlay, and optional notification sounds alert you at each phase transition. Auto-start next session keeps the flow going without manual intervention.

WHERE IT RUNS

This extension works on any website across the entire web. It functions on study pages, work documents, coding environments, social media, and any page where you want to stay focused. The tool works across all domains and adapts to dynamically loaded content and single-page applications.

HOW TO USE

Install the extension and navigate to any webpage. The Pomodoro timer overlay appears with a ready state. Use the overlay panel to configure your timer: set the focus interval in minutes (default 25), short break interval (default 5), long break interval (default 15), and the number of sessions before a long break (default 4). Choose the timer position (top-right, top-left, bottom-right, or bottom-left). Toggle "Auto-start next session" to automatically transition to the next phase without clicking. Toggle "Notification sounds" to receive alerts at phase transitions. Click "Show Timer" to display the overlay if hidden. Use the timer controls directly on the overlay — ▶ to start, ⏹ to reset, and click the timer display to pause or resume.

TECHNICAL SECTION — POMODORO TIMER ENGINE

The extension uses a setInterval-based timer engine that tracks remaining time with 1-second precision. The timer cycles through focus, short break, and long break phases based on the configured intervals. When a focus session completes, the session counter increments and the total focus time is tracked. After the configured number of sessions, a long break is triggered instead of a short break. Phase transitions trigger GM_notification alerts with custom messages ("Focus Time," "Break Time," "Long Break") when notifications are enabled. The display updates every second with the remaining time, and the phase text and color provide immediate visual feedback. The auto-start feature keeps the timer running through phase transitions without user interaction. The timer state persists through pause/resume, and the reset function returns the timer to the idle state.

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 timer 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 timer 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 Pomodoro timer is a productivity tool and should be used in conjunction with proper study and work habits. Notification sounds rely on GM_notification and may not work in all browser configurations. The timer continues running in the background as long as the page is open, even if you navigate to a different tab.