Zoom Web Meeting Timer Overlay

WHAT IT DOES

Zoom Web Meeting Timer Overlay adds a floating timer overlay that tracks the duration of Zoom web meetings. The script automatically detects when a Zoom meeting is active by monitoring the page for meeting indicators like "Meeting ID," participant lists, and control buttons. A count-up timer displays the elapsed meeting time, while a configurable countdown timer tracks the remaining time against your meeting duration limit—perfect for the 40-minute free tier limit or any custom duration. Visual warnings change the timer color from green to yellow to red as the meeting approaches the time limit, with a pulsing alert when time is critical. The overlay includes buttons to start, pause, reset, and extend the timer, and also shows a participant count badge and meeting name when available.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on the Zoom web meeting page and any other page where Zoom meetings are embedded. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, monitoring the page and managing the timer locally without sending any data to external servers.

HOW TO USE

After installation, the timer overlay appears automatically when a Zoom meeting is detected. The timer starts automatically if auto-start is enabled, or you can click the "Start" button to begin tracking. The elapsed time counts up, and the countdown shows the remaining time based on your configured meeting duration. Click "Pause" to pause the timer, "Reset" to reset it to zero, or "+5m" to extend the meeting duration by 5 minutes. The timer color changes from green to yellow to red as the meeting approaches the time limit. Open the panel to customize the meeting duration (default 40 minutes), warning threshold, timer position, and toggle compact mode, auto-start, or participant count display.

THE MECHANISM THAT MAKES IT WORK

The script uses a dual-timer system to track meeting duration. The count-up timer calculates elapsed seconds from a start timestamp using setInterval with 100ms precision, updating the display in real-time. The countdown timer subtracts elapsed seconds from the configured meeting duration and shows the remaining time in MM:SS format. Color transitions are triggered based on the remaining time relative to the warning threshold (configurable from 5-15 minutes). Meeting detection uses a multi-strategy approach: keyword matching on page text for indicators like "Meeting ID" and "participants," DOM element scanning for Zoom-specific class names and attributes, and detection of common Zoom control buttons (mute, video, chat). Participant count is extracted by scanning for numeric patterns adjacent to participant-related terms. The timer state (running, elapsed time) is stored in memory and persists across page interactions.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the timer overlay's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the tool's aesthetic. It includes an input field for meeting duration in minutes, a dropdown for warning threshold selection, toggle switches for enabling the overlay, auto-start on meeting detection, compact mode, and participant count display, and a dropdown menu for timer position (top-left, top-right, bottom-left, bottom-right). Action buttons allow you to start, pause, reset, save settings, or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The script automatically detects Zoom meetings by scanning the page content and may not work on heavily customized or non-standard Zoom interfaces. The timer's auto-start feature triggers when a meeting is detected; you can manually control the timer at any time. The countdown timer is based on the configured meeting duration and serves as a helpful reminder, not a strict enforcement mechanism. The script does not access Zoom's API or any internal meeting data—all detection is based on visible page content. No user data is collected, stored, or transmitted by this script.