Time on Site Tracker

WHAT IT DOES

Time on Site Tracker monitors how long you spend on web pages and sites, helping you understand your browsing habits and manage your time more effectively. The tool tracks three separate time measurements: page time (time on the current page), session time (time since you opened the tool or last reset), and total site time (cumulative time spent on the current domain). A live timer display shows all three times in real time, and optional milestone notifications alert you every X minutes of browsing. You can reset page, session, or site time independently, and choose between short (mm:ss) or full (1h 2m 3s) time formats.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All time tracking, counting, and storage occur on your machine without any network requests. No time data, page activity, or user behavior is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. Time data is stored locally using GM_setValue.

HOW TO USE

Click the extension toolbar icon to open the Time on Site Tracker panel. The panel displays three time measurements: Page Time, Session Time, and Site Total. Click "Reset Page Time" to reset the timer for the current page. Click "Reset Session Time" to reset the session timer. Click "Reset Site Total" to reset the cumulative time for the current site. Toggle "Show floating timer" to display a live timer overlay in the corner of your screen. Toggle "Show milestone notifications" to receive alerts at regular intervals. Toggle "Track total site time" to enable or disable cumulative site time tracking. Change the timer position using the dropdown (Bottom Right, Bottom Left, Top Right, Top Left). Adjust the "Notification Interval" to set how often milestone notifications appear (1-60 minutes). Choose the time format between Short (mm:ss) and Full (1h 2m 3s). The panel updates in real time every second.

THE TIME TRACKING ENGINE — WHY IT WORKS

Most time trackers rely on external services or complex analytics that send data to third parties. This tool uses a pure JavaScript approach with three independent timers: pageStart, sessionStart, and siteStart. Each timer is initialized when the page loads, and the difference between the current time and the start time gives the elapsed duration. The site total time is stored persistently using GM_setValue, with the session time added to the stored total when the page unloads or the browser closes. The update loop uses setInterval running every second to refresh the display and check for milestone notifications. The milestone notification system tracks elapsed session minutes and triggers a flash message when the elapsed time crosses a multiple of the notification interval. The floating timer is a fixed-position element that updates in real time, providing at-a-glance time tracking without opening the panel. This approach gives you full visibility into your time usage without any external dependencies.

THE PANEL

The Time on Site Tracker panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the time displays and controls adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to track time in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. Time tracking is based on the time the page is open and active; switching tabs or minimizing the browser does not stop the timer. The total site time is cumulative across sessions and is stored locally. Resetting the site total is permanent and cannot be undone. All time data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.