Workout Timer Overlay

WHAT IT DOES

Workout Timer Overlay displays a compact, always-visible timer overlay on any webpage, designed for interval training workouts. The timer alternates between work and rest phases based on user-configurable intervals, with a visual countdown that changes color to indicate the current phase — green for work and red for rest. The timer tracks rounds, shows a round counter, and provides notification alerts at each phase transition. Start, pause, and reset controls are built into the overlay, making it easy to manage your workout without switching tabs or apps.

WHERE IT RUNS

This extension works on any website across the entire web. It functions on workout pages, fitness blogs, streaming platforms, social media, and any page where you want to keep a workout timer visible. 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 timer overlay appears with controls. Configure your workout settings using the overlay panel: set the work interval in seconds (default 30), rest interval in seconds (default 10), and number of rounds (default 8). Customize the colors for work and rest phases. Toggle "Always show timer" to keep the timer visible at all times, or hide it and show on demand. Enable or disable notification sounds for phase transitions. Click "Show Timer" to display the overlay if hidden, or "Hide Timer" to remove it. Use the timer controls directly on the overlay — ▶ to start, ⏹ to reset, and click the timer display to pause or resume.

TECHNICAL SECTION — INTERVAL TIMER ENGINE

The extension uses a setInterval-based timer engine that tracks remaining time with 1-second precision. When started, the timer enters the work phase and counts down from the configured work interval. When it reaches zero, it transitions to the rest phase (if more rounds remain) and counts down from the rest interval. After each rest phase, the round counter increments. The timer completes when all configured rounds are finished. Phase transitions trigger GM_notification alerts with custom messages ("Work Time" and "Rest Time") when notifications are enabled. The display updates every second with the remaining time, and the phase text and color provide immediate visual feedback. 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 workout 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 a helpful tool for interval training and should be used in conjunction with proper exercise techniques. 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.