Universal Session Idle Warning

WHAT IT DOES

Universal Session Idle Warning helps you stay logged in by monitoring your inactivity and warning you before your session times out. The script tracks mouse movement, keyboard input, and clicks to detect when you're actively using the page. When you become idle, a visible countdown timer shows exactly how much time remains before your session expires, with color-coded urgency: green for more than 5 minutes remaining, yellow for 2-5 minutes, orange for 1-2 minutes, and urgent red for less than 1 minute. When the warning threshold is reached, you receive a browser notification and the panel displays options to extend your session or refresh the page. The script also shows your total session duration since login, helping you track how long you've been active.

WHERE IT RUNS

This script runs on every website (matching all URLs), detecting inactivity across the entire web. It works on any page where session timeouts are a concern—banking sites, admin panels, email clients, SaaS applications, and more. The script automatically adapts to each page and does not require any site-specific configuration.

HOW TO USE

After installing through the BotGentz extension, simply browse the web as usual. The script begins tracking your activity immediately. Use the configuration panel to customize your experience: toggle the idle badge on or off, show or hide the countdown timer, set the idle timeout threshold in minutes, configure how many minutes before timeout you want to be warned, enable auto-refresh on timeout, and show or hide session duration. The panel displays real-time statistics including your current idle time, session duration, and time until timeout. Use the "Reset Activity Timer" button to manually reset the idle counter at any time. When a warning appears, click "Extend Session" to reset the timer or "Refresh Page" to reload.

EVENT-DRIVEN ACTIVITY DETECTION WITH PREDICTIVE TIMEOUT ENGINE

This script implements a comprehensive activity monitoring system using event-driven detection across multiple interaction types. The monitoring engine captures mousemove, mousedown, click, scroll, keydown, keyup, touchstart, and touchmove events to build a complete picture of user activity. Each event resets the idle timer, keeping the session alive naturally. The predictive timeout engine calculates time remaining based on the configured idle threshold and warning threshold, displaying real-time countdown updates. The urgency color-coding system uses a multi-tier threshold model with four levels of warning severity. The script also stores session start time and idle history locally, enabling session duration tracking and idle pattern analysis without transmitting any data externally.

THE PANEL

The configuration panel is fully draggable and remembers its position per-site using GM_setValue. It snaps to screen edges when dragged near them, collapses to a compact bubble when minimized, and supports Escape key for quick collapse. All settings—including badge visibility, countdown display, idle thresholds, warning timing, auto-refresh behavior, and session duration tracking—are persisted across sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The script runs on all websites and tracks only your mouse movements, keyboard input, and click activity for the purpose of detecting inactivity. It does not capture, store, or transmit any personal information, keystroke content, or browsing data. All activity data and settings are stored locally in your browser using GM_setValue and never transmitted to external servers. This tool is designed to help you avoid session timeouts and is provided for educational purposes only. Some websites may have their own session management that overrides this script's behavior.