Meeting Timer Overlay

WHAT IT DOES

Meeting Timer Overlay is a browser extension that automatically scans the current webpage for meeting timers, countdown displays, elapsed time indicators, and meeting duration information. It detects timer-related elements by examining class names, IDs, data attributes, and text patterns for keywords like "timer", "meeting", "countdown", "duration", "elapsed", "time", "min", or "hour". The extension adds a floating "start timer" button (⏲️) next to each detected meeting element, allowing you to capture meeting name, duration, elapsed time, and custom notes with a single click. Clicking the button opens a panel where you can start, pause, or reset a timer, add notes about time extensions, agenda adjustments, overtime alerts, or any other relevant details, and store timer data locally. The timer also displays as a floating overlay at the top of the page with real-time updates, color-coded alerts (green under 30 min, yellow at 30-60 min, red over 60 min), and pause/reset controls. The extension maintains a complete timer database per meeting with timer history, duration changes, and notes for each tracked meeting. The main panel displays all tracked meetings, showing the meeting name, latest elapsed time, duration, entry count, and latest note. All data is stored locally in your browser using GM_setValue, ensuring your timer information persists across page reloads and browser sessions. This helps meeting facilitators, managers, and anyone running meetings to track meeting time, stay on schedule, and document time adjustments over time.

WHERE IT RUNS

This extension runs on any webpage that displays meeting timers, countdown displays, elapsed time indicators, or meeting duration information – including calendar applications, meeting platforms, project management tools, time tracking systems, and any page containing meeting or timer information. The extension intelligently adapts to different page structures and supports a wide range of common timer display patterns. No manual configuration is required per site; the extension automatically detects timer elements using a flexible pattern matching system. This makes it ideal for anyone who needs to track meeting time and stay on schedule.

HOW TO USE

Simply install the extension and navigate to any webpage displaying meeting timers or duration information. The extension automatically detects timer elements and places a small "start timer" button (⏲️) next to each one. Click any of these buttons to open the timer panel with the meeting name and duration pre-filled. Use the Start/Pause button to control the timer – the floating overlay at the top of the page shows the elapsed time in real-time, with color-coded alerts as the meeting progresses. Add a note about time extensions, agenda adjustments, or any other relevant detail, then click "Log Entry" to store it in your local database. A floating button (⏱️) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all tracked meetings, sorted by most recent entry, with meeting name, elapsed time, duration, entry count, and latest note displayed. Use the settings section to enable or disable auto-detection and set your default meeting duration. The "Clear All Data" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies meeting timer information with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common timer-related class patterns, IDs, and data attributes like "timer", "meeting", "countdown", "duration", and "elapsed". Second, it uses a TreeWalker to examine text nodes for timer-related text patterns, capturing timer information that may not be wrapped in typical timer elements. The meeting name extraction uses a pattern-matching engine with multiple strategies: detecting text following keywords like "meeting:", "call:", or "event:", and using data attributes. The duration extraction identifies minute and hour values from text patterns and data attributes. The timer system uses setInterval for real-time updates, with a clean architecture that manages state separately from the UI, ensuring accurate time tracking even when the panel is closed. The floating overlay is positioned at the top of the page with a z-index of 99999, ensuring it remains visible above all other page content. Color-coded alerts (green/yellow/red) provide visual cues as the meeting approaches and exceeds 30 and 60 minutes. Each tracked meeting is assigned a unique ID based on the meeting name, ensuring that history stays correctly associated. A MutationObserver detects dynamic content updates and re-scans only when new timer elements appear, balancing real-time accuracy with system performance.

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

The meeting timer panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during meetings. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The timer history and controls are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your meeting workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause timer detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all timer data, duration history, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. You are responsible for backing up your timer tracking data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any meeting systems, calendars, or site functionality – it operates solely on the static page content and stores only metadata (meeting names, durations, elapsed times, and notes) that you explicitly create. Use this tool responsibly for personal and professional meeting time management.