Time Card Calculator

WHAT IT DOES

Time Card Calculator helps you track your work hours accurately and efficiently. Enter clock-in and clock-out times for each day of the week, and the panel automatically calculates daily hours, weekly totals, and overtime. The tool supports break deductions — simply enter your break duration in minutes for each day, and the calculator subtracts it from your total. The weekly view shows your hours for the current week, and you can navigate between weeks to review past time cards. Export your time card data as a text summary with a single click, making it easy to copy into payroll systems, spreadsheets, or timesheet submissions.

WHERE IT RUNS

This script runs on every website you visit. Whether you are tracking hours on project management platforms, filling out timesheets on HR systems, managing freelance work on client portals, or simply tracking your own productivity, the panel is always available. It works alongside your existing tools without interfering with your workflow.

HOW TO USE

Select your week using the navigation buttons or click "Today" to jump to the current week. For each day, enter your clock-in time, clock-out time, and break duration in minutes. The daily hours update automatically. The summary section shows your total hours for the week, a breakdown of daily hours, and overtime calculation (based on a 40-hour standard week). Use the "Export Summary" button to copy your entire time card as formatted text to your clipboard. Adjust the default break duration in the settings, and choose whether your week starts on Monday or Sunday. All data is saved automatically and persists across browser sessions.

THE PRECISE TIME CALCULATION MECHANISM

Time Card Calculator converts all time inputs to minutes from midnight for precise arithmetic. Clock-in and clock-out times are parsed as HH:MM format and converted to total minutes since midnight. If the clock-out time is earlier than the clock-in time, the calculator correctly adds 24 hours to handle overnight shifts. The break duration in minutes is then subtracted from the total minutes worked. The result is displayed in hours and minutes (e.g., "8h 30m"). Weekly totals sum all daily minutes, and overtime is calculated as any positive difference between the weekly total and 40 hours (2400 minutes). All calculations are performed with integer arithmetic to avoid floating-point precision issues, ensuring accurate time tracking down to the minute.

THE PANEL

The panel is fully draggable and remembers its position per site. It minimizes to a compact floating bubble when collapsed. All settings — default break duration, week start preference, and saved time cards — persist across browser sessions using GM_setValue storage. Press the Escape key to close the panel. The panel automatically focuses the first clock-in input field for quick keyboard entry.

PLEASE NOTE

This script requires the free BotGentz extension to run. Time cards are saved locally in your browser and are not shared with any external service. The overtime calculation assumes a 40-hour standard work week — adjust your expectations based on your actual employment terms. Always verify your time card data before submitting to payroll. Websites change their structure and behavior over time; if any functionality stops working, the script may need an update. No user data is sent anywhere — all time card data and settings are stored locally in your browser. The script never reads or modifies password, hidden, or file input fields.