Timesheet Platform Overtime Alert Badge

WHAT IT DOES

This script scans timesheet and time-tracking dashboards—Clockify, Toggl, Harvest, Hubstaff, and others—for daily and weekly hours worked, calculates overtime totals against configurable thresholds, and displays a floating badge panel showing your current overtime status. It extracts hours from time entries, calculates daily and weekly totals, and compares them against standard thresholds (e.g., 8 hours/day, 40 hours/week). The panel shows color-coded status: green for under threshold, yellow at threshold, orange for moderate overtime, red for excessive overtime. It provides a breakdown of hours by project, overtime hours remaining or exceeded, and historical trends. Set custom daily and weekly thresholds to match your work policies. Export overtime data as CSV for reporting. All overtime snapshots are stored per domain locally for tracking trends over time.

WHERE IT RUNS

Works on any timesheet or time-tracking platform—Clockify, Toggl, Harvest, Hubstaff, Timely, or any page displaying time entries and totals. The script scans page content for hour values, project names, and time entries, making it compatible with most time-tracking tools.

HOW TO USE

The panel appears automatically when you visit a timesheet dashboard. It detects time entries and calculates daily and weekly totals. The "Overtime Status" section shows daily and weekly hours with color-coded status, overtime hours (exceeded or remaining), and a project breakdown showing hours per project. The History section shows your last 10 snapshots with daily and weekly totals. Set custom daily and weekly thresholds using the input fields—click "Set" to apply changes. Enable notifications to receive browser alerts when you exceed your thresholds. Click "Refresh Data" to rescan the page for updated time entries. Export all overtime data as CSV with dates, daily hours, weekly hours, and entry counts. Use "Clear History" to reset stored snapshots for the current domain. The panel automatically saves a snapshot each time you visit, building a history of your hours over time.

TECHNICAL MECHANISM: MULTI-PASS TIME EXTRACTION WITH HOUR PARSING AND OVERTIME CALCULATION

The script uses a comprehensive detection strategy. First, it scans all tables on the page, extracting cell values and parsing them for hour formats—decimal hours (e.g., 7.5), HH:MM format (e.g., 7:30), and "Xh Ym" format (e.g., 7h 30m). It also captures project names and descriptions from adjacent cells. Second, it scans the page text for total hours patterns like "Total: 38.5 hours" or "Weekly hours: 40." Third, it scans list items and divs for individual time entries, extracting hours and project context. All parsed hours are summed to calculate daily totals. Weekly totals are extracted directly from the page if available, or estimated based on the number of unique days with entries multiplied by the daily total. The script then calculates overtime as actual hours minus the configured daily and weekly thresholds. Color-coded status is assigned based on overtime amount: under threshold (green), at threshold (yellow), 0-2 hours over (orange/moderate), and >2 hours over (red/excessive). Each snapshot stores daily hours, weekly hours, entry count, and individual entries with project breakdowns, capped at 30 entries per domain. Notifications trigger when either daily or weekly thresholds are exceeded.

THE PANEL

The overtime monitor appears in a draggable, resizable panel that remembers its position per site. The panel shows daily and weekly hours with color-coded status, overtime details, and a project breakdown. The history section shows recent snapshots. Drag by the header to reposition, collapse to a compact icon with a click, and resize using the bottom-right corner. The panel snaps to screen edges for tidy placement and closes with the Escape key. All settings—daily/weekly thresholds, notification preference, and panel position—persist per website using GM_setValue, so your view returns exactly as you left it.

PLEASE NOTE

This script requires the free BotGentz extension to run. Time detection relies on the page displaying hours in a parsable format—some time-tracking platforms may use non-standard layouts that prevent automatic detection. The script does not access your timesheet account data beyond what is visible on the page. All overtime data is stored locally in your browser via GM_setValue and never transmitted. The script can only detect data that is currently visible on the page—ensure your timesheet view shows the relevant time entries. Hour parsing supports multiple formats (decimal, HH:MM, Xh Ym) but may not detect all variations. The weekly total estimation when not explicitly displayed assumes a 5-day workweek; adjust your view to show the full week for accurate weekly totals.