Universal Session Timeout Warning

WHAT IT DOES

Universal Session Timeout Warning monitors your activity (keyboard, mouse, scroll, touch) on any webpage and displays a prominent warning banner when inactivity reaches your defined threshold, alerting you that your session may expire soon. The banner shows a live countdown timer with the remaining time before session timeout, giving you clear visibility of how much time you have left. Click "Extend Session" to reset the inactivity timer and dismiss the warning, or click "Dismiss" to close the banner (the warning will reappear if inactivity continues). A floating status indicator shows your current session state—Active, Inactive, or Warning—at a glance, with color-coded dots and remaining time display.

WHERE IT RUNS

This script operates as a userscript within the BotGentz extension on any webpage that uses session-based authentication or where inactivity can lead to session expiration, including web applications, admin panels, banking sites, email clients, and SaaS platforms. It functions on any modern browser that supports the BotGentz extension, including Chrome, Firefox, Edge, Safari, and Opera. The script runs entirely client-side, monitoring activity and managing timers locally without sending any data to external servers.

HOW TO USE

After installation, the script automatically begins monitoring your activity. A floating status indicator appears in the bottom-left corner showing your session state. When you reach the inactivity threshold, a red warning banner appears with a countdown timer. Click "Extend Session" to reset the timer and keep your session alive, or "Dismiss" to close the warning. Open the panel to customize the inactivity threshold (1-60 minutes), warning display time (10-120 seconds), toggle auto-extend, enable or disable the status indicator, adjust banner position (top or bottom), or change the status indicator position. Use the "Reset Timer" button to manually reset the inactivity timer, or "Pause Monitor" to temporarily stop monitoring.

THE MECHANISM THAT MAKES IT WORK

The script uses a dual-timer system to manage session warnings. The primary inactivity timer tracks the time since the last user interaction (mousemove, mousedown, keydown, scroll, touchstart, or click events). When this timer reaches the user-defined threshold, instead of immediately showing a warning, it triggers a secondary countdown timer. This countdown timer displays the remaining seconds in the warning banner and automatically dismisses the warning when it reaches zero. The "Extend Session" button resets both timers and dismisses the warning, effectively simulating user activity. The status indicator updates every 5 seconds to show the current state, using color-coded dots (green for active, yellow for inactive/warning, red for critical) and time remaining. All timers are managed using setTimeout and setInterval with proper cleanup on page unload.

THE PANEL

The script panel is built using BotGentz's BGPanel framework and provides comprehensive control over the session monitor's behavior. The panel opens as a floating overlay that can be dragged anywhere on your screen, with a clean dark theme matching the tool's aesthetic. It includes dropdown menus for inactivity threshold (1-60 minutes), warning display time (10-120 seconds), banner position (top or bottom), and status indicator position (top-left, top-right, bottom-left, bottom-right). Toggle switches enable or disable the monitor, show the status indicator, auto-extend the session, and play a notification sound when the warning appears. Action buttons allow you to reset the timer, pause the monitor, save settings, or reset all settings to defaults. The panel collapses to a small icon when not in use and expands when clicked, remaining accessible but unobtrusive. Press the Escape key at any time to close the panel.

PLEASE NOTE

This script requires the free BotGentz extension to be installed and activated in your browser. The extension is available from the official BotGentz website. The script monitors activity only within the current page tab and does not track activity across tabs or windows. The inactivity timer resets when you interact with the page; if you switch tabs, the timer continues to run. Some sites may have their own session timeout mechanisms that are shorter than the script's threshold; the script is designed as an early warning system and may not override the site's native timeout. The auto-extend feature requires the script to be enabled; it works by simulating activity when the warning appears. No data is collected, stored, or transmitted by this script; all processing is performed locally in your browser.