Timesheet Entry Helper

WHAT IT DOES

Timesheet Entry Helper is a browser extension that automatically scans the current webpage for timesheet entry fields, project selectors, task inputs, time entry forms, and day/date fields. It detects timesheet-related form elements by examining class names, IDs, name attributes, and placeholder text for keywords like "project", "task", "hours", "time", "date", "description", or "notes". The extension adds a floating "quick fill" button (⏱️) near detected form fields, allowing you to auto-populate project, task, hours, date, description, and notes fields with a single click. Clicking the button opens a panel where you can select from saved tasks, enter new entry details, or save current entries as reusable tasks. The extension maintains a timesheet entry database per project and task with entry history, notes, and tags. Each entry stores the project name, task description, hours worked, date, work description, notes, and tags. The main panel displays saved tasks and entry history, showing recent entries with hours, dates, and notes. All data is stored locally in your browser using GM_setValue, ensuring your timesheet data persists across page reloads and browser sessions. This helps freelancers, consultants, employees, and project managers quickly fill out timesheet forms, track time across different projects, and maintain a history of work entries for reporting and billing purposes.

WHERE IT RUNS

This extension runs on any webpage that displays timesheet entry forms, project management tools, time tracking systems, expense report forms, or any page with input fields for project, task, hours, and date. The extension intelligently adapts to different page structures and supports a wide range of common form display patterns. No manual configuration is required per site; the extension automatically detects form fields using a flexible pattern matching system. This makes it ideal for users who regularly fill out timesheets in multiple systems or platforms.

HOW TO USE

Simply install the extension and navigate to any webpage with a timesheet or time entry form. The extension automatically detects form fields and places a "quick fill" button (⏱️) in the bottom-right area of the page. Click this button to open the quick fill panel. The panel shows your saved tasks for quick selection, or allows you to manually enter project, task, hours, and optional note. Click "Fill Fields" to auto-populate the detected form fields with your entered data – the extension automatically sets each field's value and dispatches the proper input and change events to ensure compatibility with React, Vue, and other modern frameworks. You can also click "Save as Task" to save the current entry as a reusable task for future use. A floating button (📋) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all saved tasks and recent entry history. Use the settings section to enable or disable auto-detection and set your default hours value. The "Clear All Entries" and "Clear Saved Tasks" buttons remove tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies timesheet form fields with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common field class patterns, IDs, name attributes, and placeholder text for project, task, hours, date, description, and notes fields. The detection algorithm uses a weighted scoring system where each matching selector contributes to a confidence score – a field with multiple matching selectors (class, name, and placeholder) receives a higher confidence score. The extension prioritizes visible form elements over hidden ones, ensuring it identifies the fields the user is actively interacting with. When auto-populating fields, the extension uses the native setter for each input element and dispatches both "input" and "change" events, ensuring that React and Vue applications recognize the value change and update their state accordingly. Each timesheet entry is stored with a unique ID based on the project and task name, and the extension maintains a complete history of all entries. A MutationObserver detects dynamic content updates and re-scans only when new form elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The timesheet helper panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during data entry. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The task list and entry history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your timesheet workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause form field detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all timesheet entries, task data, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. You are responsible for backing up your timesheet data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any billing systems, payroll processing, or site functionality – it operates solely on the static page content and stores only metadata (project names, tasks, hours, dates, and notes) that you explicitly create. Use this tool responsibly for personal and professional timesheet management.