Payroll Platform Pay Period Countdown

WHAT IT DOES

Payroll Platform Pay Period Countdown keeps you informed about upcoming pay dates and payroll deadlines by adding visual countdown timers directly to your payroll dashboard. The script reads payroll data from the page—including pay period dates, pay dates, employee counts, gross pay amounts, and payroll run statuses—then displays countdown timers showing exactly how many days remain until the next pay date. Color-coded urgency indicators make it easy to see which pay dates are approaching: green for more than 7 days away, yellow for 3-7 days, orange for 1-3 days, and urgent red for pay dates within 24 hours. A progress bar shows how far through the current pay period you are. The next pay date and pay period end date are prominently displayed, and an upcoming schedule shows all future pay dates in chronological order.

WHERE IT RUNS

This script operates on all major payroll platforms including Gusto, Paylocity, ADP, Paychex, BambooHR, Zenefits, and PeopleFluent. It works on payroll dashboards, pay period views, run payroll pages, and employee management interfaces. The script automatically detects which platform you're using and adapts its extraction strategy to that site's specific interface.

HOW TO USE

After installing through the BotGentz extension, navigate to your payroll platform dashboard or pay period view. The script automatically scans the page for pay date information and displays countdown timers and progress indicators. Use the configuration panel to customize your experience: toggle the countdown badge on or off, show or hide the pay date progress bar, enable or disable color-coded urgency, control the visibility of the next pay date, and show or hide the payroll schedule. The panel displays real-time statistics including total pay dates found, upcoming count, and days until the next pay date. Use the "Scan Payroll Data" button to manually refresh the data at any time.

PLATFORM-ADAPTIVE DATE EXTRACTION WITH MULTI-STRATEGY PARSING

This script implements a specialized payroll data extraction engine that adapts to each platform's unique HTML structure. The engine maintains distinct selector strategies for all supported payroll platforms, targeting platform-specific elements like pay date fields, period end displays, and run status indicators. Beyond DOM extraction, the engine employs a multi-strategy date parser that handles named month formats ("January 15, 2024"), numeric formats ("01/15/2024"), ISO formats ("2024-01-15"), and relative expressions found in page content. The parser attempts multiple parsing strategies in sequence, falling back to broader patterns when specific selectors fail. This layered approach ensures reliable date detection across different payroll interfaces and regional date formats. The countdown engine calculates days until each pay date and updates in real-time with a 60-second refresh cycle.

THE PANEL

The configuration panel is fully draggable and remembers its position per-site using GM_setValue. It snaps to screen edges when dragged near them, collapses to a compact bubble when minimized, and supports Escape key for quick collapse. All settings—including badge visibility, progress bar preferences, urgency coloring, and auto-refresh interval—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Payroll platforms periodically update their page structures, which may affect the script's ability to extract date data—we actively maintain the script and release updates to ensure compatibility. The script reads only publicly visible payroll data displayed on your dashboard and does not access hidden fields, passwords, or sensitive employee information. All extracted data stays local in your browser and is never transmitted to external servers. This tool is designed to help you manage payroll timing and is not affiliated with or endorsed by any payroll platform.