Replit Web Session Timer

WHAT IT DOES

Replit Web Session Timer tracks how long you've been coding in your Replit projects with a persistent, real-time timer. It displays elapsed time in hours:minutes:seconds format, updating every second, and persists across page refreshes so you never lose your session time. The timer includes idle detection—it automatically pauses when you step away from your keyboard for a configurable period, so only active coding time is counted. You can set session goals (e.g., "code for 1 hour") with a visual progress bar and desktop notification when the goal is reached. The panel also shows your total time spent coding today, and you can start, pause, reset, or hide the timer at any time. The timer overlay is draggable and can be repositioned anywhere on your screen.

WHERE IT RUNS

This script runs exclusively on Replit pages (*.replit.com/*). It operates entirely within your browser tab, storing session data locally using GM_setValue. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including timer visibility, position, idle detection, threshold, session goal, daily total display, and auto-start preference—are stored locally and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the timer automatically starts when you load a Replit project (if auto-start is enabled). A floating overlay shows the current session time with a progress bar if a goal is set. Use the panel to control the timer: click "Start Timer" to begin tracking, "Pause Timer" to pause, and "Reset Timer" to reset the session. Customize the timer position (top-left, top-right, bottom-left, bottom-right, or float), toggle idle detection and set the idle threshold (1-30 minutes), set a session goal (0-480 minutes, 0 to disable), and show or hide the daily total. Click "Copy Session Stats" to copy your session time, daily total, and goal progress to the clipboard.

THE REAL MECHANISM

The script tracks time using a combination of timestamp tracking and elapsed time accumulation. When the timer starts, it records the session start timestamp in memory and stores it in GM_setValue. Every second, the script calculates the elapsed time as (current time - start time) + previously accumulated elapsed time, ensuring accuracy even if the timer is paused and resumed. The state is saved to GM_setValue every 30 seconds and on important events (start, pause, reset) to survive page refreshes. Idle detection tracks mouse movements, keyboard presses, and clicks; if no activity is detected for the configured threshold (default 5 minutes), the timer automatically pauses. When activity resumes, the timer resumes automatically. The session goal feature compares elapsed time against the goal in seconds and triggers a desktop notification when the goal is reached. The progress bar updates in real-time, showing the percentage of the goal completed. The timer overlay is a floating div with drag support using mousedown/mousemove/mouseup events.

THE PANEL

The Session Timer panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the settings. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. The timer tracks time spent in the active Replit tab—if you switch to another tab, the timer continues running but idle detection may pause it if you're inactive. The timer persists across page refreshes using GM_setValue, but if you clear your browser data, the session data will be lost. Idle detection is approximate and may not catch all idle periods perfectly. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your session state (start time, elapsed time, daily total, last date), timer position, idle settings, goal, and display preferences locally. No coding data, project information, or personal information is ever collected, transmitted, or shared.