Time Zone Meeting Conflict Highlighter

WHAT IT DOES

This script scans the page for meeting times and time zone references, then displays a floating overlay showing the current time across multiple user-configured time zones alongside any detected meeting times. It automatically highlights scheduling conflicts—meetings outside working hours, overlapping meetings, and time zone mismatches—with color-coded visual indicators. A badge shows the number of detected issues, and the overlay updates every 10 seconds to keep time information current. Perfect for remote teams, global workers, and anyone scheduling meetings across time zones.

WHERE IT RUNS

The script works on any website with meeting times or schedule information—calendar apps (Google Calendar, Outlook), scheduling tools (Calendly, Doodle), project management platforms (Asana, Trello), email clients, and any page with time references. It detects meeting times using text pattern recognition and works on any website regardless of framework.

HOW TO USE

After installation, the overlay appears automatically showing your configured time zones and any detected meetings. Open the panel to customize: configure time zones via JSON array with label and offset (hours from UTC), set working hours start and end (0-23), toggle overlay visibility, show or hide the urgent badge, enable or disable meeting detection and outside-hours highlighting, choose dark or light theme, and set overlay position. Click the badge to toggle the overlay, or the ✕ button to hide it. The script automatically detects meeting times on the page and flags conflicts with visual indicators.

TECHNICAL MECHANISM

The script uses a multi-stage time zone and meeting detection pipeline. First, it loads user-configured time zones from GM_setValue as a JSON array with label and offset. Second, it detects the local time zone offset using `new Date().getTimezoneOffset()` and includes it alongside user zones. Third, it scans the page for meeting times using a TreeWalker and text pattern matching with regex for time formats (e.g., "2:30 PM", "14:30", "2pm - 3pm"). Fourth, it calculates the current time in each zone by applying the offset to the current UTC time. Fifth, it checks for conflicts by comparing each zone's current hour against the configured working hours (start to end). Sixth, it highlights outside-hours zones with warning icons and badges. Seventh, it renders the overlay using dynamic HTML with a 10-second refresh interval for real-time updates. Eighth, it maintains per-site memory for position preferences using GM_setValue.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Meeting detection uses text pattern matching and may not capture all meeting formats or time references. The script does not access, store, or transmit any personal data, calendar entries, or browsing history. All processing happens locally in your browser and never leaves your device.