Recurring Meeting Fatigue Counter

WHAT IT DOES

Recurring Meeting Fatigue Counter is a productivity tool that quantifies the cognitive load of your recurring meetings. It scans your calendar pages—Google Calendar, Outlook Web, and others—and calculates a fatigue score from 0-100 based on total meeting count, total hours spent in meetings, meeting frequency, and the proportion of recurring events. The tool provides a color-coded rating (Low/Medium/High) and a detailed breakdown: recurring vs. one-off meetings, total meeting time per week, average meeting duration, and a "meeting density" indicator showing your busiest days and hours. Most importantly, it generates actionable recommendations to reduce fatigue—like identifying days with excessive meetings, flagging recurring meetings that may no longer be necessary, and suggesting consolidation opportunities. This gives you a data-driven approach to reclaiming your time and reducing cognitive overload.

WHERE IT RUNS

This script runs on any calendar page—Google Calendar, Outlook Web, Calendly, Apple Calendar, Yahoo Calendar, and Teamup. It operates entirely within your browser tab, reading the page's DOM to locate event elements, extract titles, and parse start/end times. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including fatigue thresholds, workday hours, weekly meeting targets, and prep time inclusion—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically analyzes your calendar on load. The panel displays your fatigue score with a color-coded gauge (green for low, yellow for medium, red for high), followed by a breakdown of recurring vs. one-off meetings and average meeting duration. A day-by-day bar chart shows your busiest days, and a "meeting density" section highlights the most crowded hours. The recommendations section provides specific, actionable advice like "You have 3 recurring meetings on Tuesday—consider consolidating" or "Total meeting time: 12 hrs. Aim for under 8 hrs." Click "Analyze Calendar" to manually re-run analysis after making changes. Adjust fatigue thresholds, workday hours, and weekly meeting targets in the settings to match your personal thresholds. Click "Copy Report" to export a summary of your meeting metrics and recommendations.

THE REAL MECHANISM

The script uses a platform-aware event extraction engine with selectors for Google Calendar, Outlook, Calendly, and other calendars, including a generic fallback that scans for common calendar patterns. For each detected event, the script extracts the title and parses start/end times using regular expressions (supporting both 12-hour and 24-hour formats), with fallback to data attributes and duration hints in the text. Events are marked as recurring by checking for keywords like "recurring," "repeats," "weekly," "daily," and "series" in event text, title attributes, and ARIA labels. The fatigue score is calculated as a weighted composite of four factors: total meetings (capped at 40), total hours (capped at 40), recurring percentage (capped at 30), and meeting density. Each factor is weighted to reflect its impact on cognitive load. The score is then mapped to a rating using user-configurable Low and Medium thresholds. Recommendations are generated from a rule engine that evaluates total meetings, meeting hours, recurring count, busiest day, busiest hour, average duration, and recurring percentage, delivering up to six prioritized suggestions.

THE PANEL

The Meeting Fatigue panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the analysis. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Calendar platforms frequently update their user interfaces, which may change class names and event structures—the script may require updates to maintain compatibility. The fatigue score is a heuristic tool based on common meeting fatigue research; it should be used as a guide, not a definitive metric. Time extraction relies on visible page content; events that are not visible on the current screen may not be detected. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your fatigue thresholds, workday hours, weekly meeting target, and prep time preference locally. No calendar data, event information, or personal information is ever collected, transmitted, or shared.